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About This Manual 

Purpose 

The purpose of the XE 500 CENTIX Operations Reference 
Manual is to provide a comprehensive reference for the 
XE 500 CENTIX operating system. 

Scope 

This manual describes the commands, system calls, libraries, 
data files, and device interfaces that make up the CENTIX 
Operating System running on the XE 500 computer. 

Audience 

Volumes 1 and 2 of this manual are intended for all users of 
the CENTIX operating system. CENTIX system programmers 
are the primary audience for Volumes 3 and 4. 

Prerequisites 

General users of the CENTIX system should be familiar with 
the particular environments in which they will be working. A 
section called Getting Started, preceding the Shell Command 
descriptions in Volumes 1 and 2, provides a generic CENTIX 
tutorial. 

Programmers should have an understanding of the CENTIX 
operating system structure and should be experienced at 
writing programs in the C programming language. 
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How to Use This Manual 

Use this manual as a starting point to find the documentation 
for a CENTIX feature with which you are unfamiliar. To find 
the entry you need, refer to the following: 

□ Permuted Index. This indexes each significant word in each 
entry's description. A complete Permuted Index for the 
whole manual is in each volume. 

□ Contents Listing. Included in the Contents Listing is an 
alphabetical list of entries, under the appropriate sections, 
together with the entry descriptions. Each volume contains 
the Contents Listing. 

□ Related Shell Command Entries. This section, for Volumes 
1 and 2 only, groups together related shell command 
entries that are in Section 1 . 



Organization 

This manual consists of six sections: 

Section 1 , Shell Commands, describes programs that are 
intended to be invoked directly by the user throuqh the 
CENTIX System shell. 

Section 2, System Calls, describes the entries into the 
CENTIX kernel, including the C language interfaces. 

Section 3, Library Functions, describes the available 
library functions and subroutines. 

Section 4, Special File Formats, documents the structure 
of particular kinds of files. 

Section 5, Miscellaneous Facilities, includes descriptions 
of macro packages, character set tables, and so on. 

Section 6, Device Files, describes various device files 
that refer to specific hardware peripherals and CENTIX 
System device drivers. 
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System Calls 
intro 

Name 

intro - introduction to system calls and error numbers 

Format 

#include <errno.h> 

Description 

This section describes all of the XE 500 CENTIX system 
calls. System calls are functions that call the CENTIX kernel. 
They are used to perform a variety of system-dependent 
tasks, such as accessing files, opening pipes, and controlling 
your CENTIX environment. System calls are handled in a way 
similar to C language library functions (see Section 3), 
although they are accessible from other languages, as well. 

Most system calls have one or more error returns. An error 
condition is indicated by an otherwise impossible return 
value, which is almost always -1; the individual descriptions 
specify the details. An error number is also made available in 
the external variable errno (see perror in Section 3). errno is not 
cleared on successful calls, so it should be tested only after 
an error has been indicated. 

Each system call description attempts to list all possible error 
numbers. The following is a complete list of the error 
numbers and their names as defined in <errno.h>. 

1 EPERM Not owner 

Typically, this error indicates an attempt to modify a file in 
some way forbidden except to its owner or the super-user. 
It is also returned for attempts by ordinary users to do 
things allowed only to the super-user. 
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2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file 
should exist, but doesn't. It also occurs when one of the 
directories in the path name does not exist. 

3 ESRCH No such process 

No process can be found corresponding to that specified 
by pid in a kill. 

1 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), which 
the user has chosen to catch, has occurred during a 
system call. If execution is resumed after the signal is 
processed, it will appear as if the interrupted system call 
returned this error condition. 

5 EIO I/O error 

Some physical I/O error has occurred. This error may, in 
some cases, occur on a call following the one to which it 
actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice that does not 
exist, or beyond the limits of the device. It may also occur 
when, for example, a tape-drive is not on-line or no disk 
pack is loaded on a drive. On local terminals, it may 
indicate that the host terminal lacks the specified channel. 

7 E2BIG Arg list too long 

An argument list longer than 10K bytes is presented to a 
member of the exec family, or an item (such as a file) would 
become too large. 

8 ENOEXEC Exec format error 

A request is made to execute a file that, although it has 
the appropriate permissions, does not start with a valid 
magic number (see a.out in Section 4). 
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9 EBADF Bad file number 

Either a file descriptor refers to an unopen file, or a read (or 
write) request is made to a file that is only open for writing 
(or reading). 

10 ECHILD No child processes 

A wait was executed by a process that had no existing or 
unwaited-for child processes. 

11 E AGAIN No more processes 

A fork failed because the system's process table is full or 
the user is not allowed to create any more processes. 

12 ENOMEM Not enough space 

During an exec, hrk, or sbrk, a program asks for more space 
than the system is able to supply. The maximum allocation 
is 3.5 megabytes; a program that gets this condition with 
a smaller allocation may work at another time when other 
large programs are not hogging the swap file. If this 
problem recurs, the system administrator may want to 
consider enlarging the swap file. 

The error may also occur if the arrangement of text, data, 
and stack segments requires too many segmentation 
registers, or if there is not enough swap space during a fork. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden 
by the protection system. From locking, an attempt was 
made to do a checking lock on bytes already under a lock. 

14 EFAULT Bad address 

The system encountered a bad pointer in attempting to 
use an argument of a system call. 

15 ENOTBLK Block device required 

A non-block file was mentioned where a block device was 
required (such as in mount). 
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16 EBUSY Device or resource busy 

An attempt was made to mount a device that was already 
mounted, or an attempt was made to dismount a device 
on which there is an active file (open file, current directory, 
mounted-on file, active text segment). It will also occur if 
an attempt is made to enable accounting when it is already 
enabled. The device or resource is currently unavailable. 

17 EEXIST File exists 

An existing file was mentioned in an appropriate context, 
such as link. 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system 
call to a device (for example, read a write-only device). 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is 
required (for example, in a path prefix or as an argument to 
chdir). 

21 EISDIR Is a directory 

An attempt was made to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument (such as dismounting a 
non-mounted device, mentioning an undefined signal in 
kill, reading or writing a file for which Iseek has generated a 
negative pointer). Also set by the math functions 
described in the math library functions in Section 3 of this 
manual. 

23 EINFILE File table overflow 

The system table file is full, and temporarily no more opens 
can be accepted. 
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24 EMFILE Too many open files 

No process may have more than 20 file descriptors open 
at a time. 

25 ENOTTY Not a character device 

An attempt was made to perform an ioctl call to a file that 
is not a special character device. 

26 ETXTBSY Text file busy 

An attempt was made to execute a pure-procedure 
program that is currently open for writing. Also, an 
attempt to open for writing a pure-procedure program that 
is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size 
(1,082,201,088 bytes). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space 
left on the device. This can occur in a PILF file when the 
file system lacks unallocated clusters as big as the file's 
cluster size. On tape files, it indicates a read past the end 
of the tape. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a 
device mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than the maximum number of 
links (1000) to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read 
the data. This condition normally generates a signal; the 
error is returned if the signal is ignored. 
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33 EDOM Math argument 

The argument of a function in the math package (see intro 
to Section 3) is out of the domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (see intro to 
Section 3) is not representable within machine precision. 

35 ENOMSG No message of desired type 

An attempt was made to receive a message of a type that 
does not exist on the specified message queue. 

36 EIDRM Identifier removed 

This error is returned to processes that resume execution 
due to the removal of an identifier from the file system's 
name space. 

37 ECHRNG Channel number out of range. 

38 EL2NSYNC Level 2 not synchronized. 

39 EL3HLT Level 3 halted. 

40 EL3RST Level 3 reset. 

41 ELNRNG Link number out of range. 

42 EUNATCH Protocol driver not attached. 

43 ENOCSI No CSI structure available. 

44 EL2HLT level 2 halt. 

50 EBADE Invalid exchange 

Use of an invalid Inter-CPU Communication exchange 
descriptor. 

51 E8ADR Invalid request descriptor 

Use of an invalid Inter-CPU Communication request 
descriptor. 
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52 EXFULL Exchange full 

An Inter-CPU Communication request failed because an 
exchange is full. The exchange might be the request's 
response exchange or the service exchange. 

53 ENOANO No anode 

The Application Processor has as many files open as it can 
handle. 

54 EBADRQC Invalid request code 

No CENTIX or BTOS process is servicing the specified 
request code. 

56 EDEADLOCK Deadlock error 

Call cannot be honored because of potential deadlock or 
because lock table is full. See locking. 

Definitions 

The following definitions describe terms that are used 
frequently throughout the system call and library function 
documentation. 

Directory 

Directory entries are called links. By convention, a directory 
contains at least two links, . and .., referred to as "dot" and 
"dot-dot." "Dot" refers to the directory itself and "dot-dot" 
refers to its parent directory. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective 
group ID that are used to determine file access permissions 
(see below). The effective user ID and effective group ID are 
equal to the process's real user ID and real group ID, unless 
the process or one of its ancestors evolved from a file that 
had the set-user-ID bit or set-group-ID bit set; see exec. 
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File Access Permissions 

Read, write, and execute/search permissions on a file are 
granted to a process if one or more of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches the user ID 
of the owner of the file and the appropriate access bit of 
the "owner" portion (0700) of the file mode is set. 

The effective user ID of the process does not match the 
user ID of the owner of the file, and the effective group 
ID of the process matches the group of the file and the 
appropriate access bit of the "group" portion (070) of the 
file mode is set. 

The effective user ID of the process does not match the 
user ID of the owner of the file, and the effective group 
ID of the process does not match the group ID of the file, 
and the appropriate access bit of the "other" portion (07) 
of the file mode is set. 



File Descriptor 

A file descriptor is a small integer used to do I/O on a file. 
The value of a file descriptor is from 0 to 1 9. A process may 
have no more than 20 file descriptors (0-19) open 
simultaneously. A file descriptor is returned by system calls 
such as open or pipe. The file descriptor is used as an 
argument by calls such as read, write, ioctl, and close. 
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File Name 

Names consisting of 1 to 14 characters may be used to 
name an ordinary file, special file, or directory. These 
characters may be selected from the set of all character 
values excluding \0 (null) and the ASCI! code for / (slash). 
Note that it is generally unwise to use \ ?, [, or ] as part of 
file names because of the special meaning attached to these 
characters by the shell (see sh in Section 1). Although 
permitted, avoid the use of unprintable characters in file names. 



Message Queue Identifier 

A message queue identifier (msqid) is a unique positive 
integer created by an msgget system call. Each msqid has a 
message queue and a data structure associated with it. The 
data structure is referred to as msqid-ds and contains the 
following members: 



struct msq i d_d s 



struct 


i pc. 


_pe rm msg_pe rm 


u s ho r t 
u s ho r t 


msg. 
msg. 


_qnum; 
_q b y t e s ; 


u s ho r t 


msg. 


_l sp i d ; 


usho r t 


msg. 


_l r p i d ; 


t i me_t 
t ime_t 
t i me_t 


msg. 
msg 
ms g 


_s t i me ; 
_r t i me ; 
_c t i me ; 



/•operation permiss. struct'/ 

/'number ol msgs on q'/ 
/"max number of bytes on q*/ 

/•pid of last msgsnd oper.'/ 

/'pid of last msgrcv oper.'/ 

/'last msgsnd time"/ 
/'last msgr c v t ime ' / 
/•last change time'/ 
/•Times measured in seconds"/ 

/'since 00:00:00 GMT, 1/1/70'/ 



Msg-perm is an ipc_perm structure that specifies the 
message operation (see below). This structure includes the 
following members: 

struct msg_pe rm { 

ushort cuid; /'creator user ID*/ 

ushort cgid; /'creator group ID'/ 

ushort uid; /'user ID*/ 

ushort gid; /'group ID*/ 

ushort mode; / * r /w permission*/ 
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Msg_qnum is the number of messages currently on the 
queue. Msg^qbytes is the maximum number of bytes allowed 
on the queue. MsgJspid is the process ID of the last process 
that performed an msgsnd operation. MsgJrpid is the 
process ID of the last process that performed an msgrcv 
operation. Msg^stime is the time of the last msgsnd operation, 
msg^rtime is the time of the last msgrcv operation, and 
msg-ct/me is the time of the last msgctl operation that 
changed a member of the above structure. 



Message Queue Operation Permissions 

In the msgop and msgctl system call descriptions, the 
permission required for an operation is given as "{token}," 
where "token" is the type of permission needed, interpreted 
as follows: 

00400 Read by user. 

00200 Write by user. 

00060 ^ Read, Write by group. 
00006 Read, Write by others. 

Read and Write permissions on a message queue identifier 
are granted to a process if one or more of the following are true: 

The effective user ID of the process is super-user 

The effective user ID of the process matches 
msg^perm.fcjuid in the data structure associated with 
msqid and the appropriate bit of the "user" portion 
(0600) of msg_perm.mode is set. 

The effective user ID of the process does not match 
msg_perm.[cjuid and the effective group ID of the process 
matches msg_perm.[c]gid and the appropriate bit of the 
group" portion (060) of msg_perm.mode is set 
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The effective user ID of the process does not match 
msg-perm.[c]uid and the effective group ID of the process 
does not match msg.perm.[c]gicl and the appropriate bit 
of the "other" portion (06) of msg_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 



Parent Process ID 

A new process is created by a currently active process; see 
fork. The parent process ID of a process is the process ID of 
its creator. 

Path Name and Path Prefix 

A path name is a null-terminated character string starting 
with an optional slash (/), followed by zero or more directory 
names separated by slashes, optionally followed by a file name. 

More precisely, a path name is a null-terminated character 
string constructed as follows: 

<path-name>: : -<f i I e-name> <pa t h - pr e f i xxf I I e - name> / 

<path-pref ix>: :-<rtpref ix> /<rtprof ix> 

<r t pref i x>: : -<d i r name>/ <r t pref i xxd i r names-/ 

where <file-name> is a string of 1 to 14 characters other 
than the ASCII slash and null, and <dirname> is a string of 1 
to 14 characters (other than the ASCII slash and null) that 
names a directory. 

If a path name begins with a slash, the path search begins at 
the root directory. A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is 
treated as if it named a non-existent file. 
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Process Group 10 

Each active process is a member of a process group that is 
identified by a positive integer called the tty group ID. This ID 
is the process ID of the group leader. This grouping permits 
the signaling of related processes; see kill. 



Process ID 

Each active process in the system is uniquely identified by a 
positive integer called a process ID. The range of this ID is 
from 1 to 30,000. 



Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive 
integer called a real user ID. Each user is also a member of a 
group. The group is identified by a positive integer called the 
real group ID. 

An active process has a real user ID and a real group ID that 
are set to the real user ID and real group ID of the user 
responsible for the creation of the process. 



Root Directory and Current Working Directory 

Each process has associated with it a concept of a root 
directory and a current working directory for the purpose of 
resolving path name searches. The root directory of a 
process need not be the root directory of the root file system. 
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Semaphore Identifier 

A semaphore identifier (semid) is a unique positive integer 
created by a semget system call. Each semid has a set of 
semaphores and a data structure associated with it. The data 
structure is referred to as semid-ds and contains the 
following members: 



struct semid_ds { 

struct ipc_perm sem_perm; 

u short sem_nsems; 
t ime_t sem_otime; 
t lme_t sem_c t ime ; 



/'operation permiss. struct*/ 

/'number of sems in set*/ 
/•last operation time*/ 
/ * last change t ime* / 
/•Times measured in seconds*/ 



/•since 00:00:00 GMT, 1/1/70*/ 



Sem-perm is an ipc_perm structure that specifies the 
semaphore operation permission (see below). This structure 
includes the following members: 

struct sem_perm f 

ushort cuid; /'creator user ID*/ 

ushort cgld; /'creator group ID*/ 

ushort uid; /"user ID'/ 

ushort gld; /'group ID*/ 

ushort mode; /*r/a permission*/ 

} 

The value of sem-nsems is equal to the number of 
semaphores in the set. Each semaphore in the set is 
referenced by a positive integer referred to as a semuium. 
Sem-num values run sequentially from 0 to the value of 
sem-nsems minus 1 . Semuotime is the time of the last semop 
operation, and semuctime is the time of the last semctl 
operation that changed a member of the above structure. 
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A semaphore is a data structure that contains the followinq 
members: a 



struct { 

ushort semval; /•semaphore value*/ 



} 



short sempid; /'pid of the last operation'/ 
ushort semncnt; /•# awaiting semval > oval*/ 
ushort semzcnt; /•# awaiting semval - 0*/ 



Semval is a non-negative integer. Sempid is equal to the 
process ID of the last process that performed a semaphore 
operation on this semaphore. Semncnt is a count of the 
number of processes that are currently suspended awaiting 
this semaphore's semval to become greater than its current 
value. Semzcnt is a count of the number of processes that 
are currently suspended awaiting this semaphore's semval to 
become zero. 



Semaphore Operation Permissions 

In the semop and semctl system call descriptions, the 
permission required for an operation is given as "{token}," 
where "token" is the type of permission needed, interpreted 
as follows: 

00400 Read by user. 

00200 Alter by user. 

00060 Read, Alter by group. 

00006 Read, Alter by others. 

Read and Alter permissions on a semid are granted to a 
process if one or more of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches 
sem-perm.[cju/d in the data structure associated with 
semid and the appropriate bit of the "user" portion 
(0600) of sem_perm.mode is set. 
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The effective user ID of the process does not match 
sem-perm.[c]uid and the effective group ID of the process 
matches sem^perm.[c]gid and the appropriate bit of the 
"group" portion (060) of sem_perm.mode is set. 

The effective user ID of the process does not match 
sem-perm.[c]uid and the effective group ID of the process 
does not match sem-fierm.fcjgid and the appropriate bit 
of the "other" portion (06) of sem_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 



Shared Memory Identifier 

A shared memory identifier (shmid) is a unique positive 
integer created by a shmget system call. Each shmid has a 
segment of memory (referred to as a shared memory 
segment) and a data structure associated with it. The data 
structure is referred to as shmid-ds and contains the 
following members: 

struct shmid_ds { „♦,„,.»• 
struct lpc_perm shm_perm; /'operation parmlss. struct 
int shm_segsz; /'size of segment*/ 

ushort shm_cpld; /"creator pld'/ 

ushort shm_!pid; / ' P ' * of last operation / 

short shm_nattch; /'number of cu r r en a t t aches 

time_t shm_atime; /"last attach time 

time_t shm.dtime; /'last detach time 

time t shm_ctime; /'last change t .me / 

- /'Times measured in seconds 

/'since 00:00:00 GMT, 1/1/70 

} 

Shm-perm is an ipc_perm structure that specifies the shared 
memory operation permission (see below). This structure 
includes the following members: 

struct shm_pe rm { 

ushort cuid; /'creator user ID'/ 

ushort cgid; /'creator group ID'/ 

ushort uld; /'user ID'/ 

ushort gid; /'group ID'/ 



usho r t 



mode ; / • r /w pe r m i s s i on ' / 
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Shmsegsz specifies the size of the shared memory segment 
Shm^cpid is the process ID of the process that created the 
shared memory identifier. ShmJpid is the process ID of the 
last process that performed a shmop operation. Shm^nattch is 
the number of processes that currently have this segment 
attached. Shm^atime is the time of the last shmat operation, 
shm^dtime is the time of the last shmdt operation, and 
shm_ctime is the time of the last shmctl operation that 
changed one of the members of the above structure. 

Shared Memory Operation Permissions 

In the shmop and shmctl system call descriptions, the 
permission required for an operation is given "{token}," 
where "token" is the type of permission needed, interpreted 
as follows: 

00400 Read by user. 



Read and Write permissions on a shmid are granted to a 
process if one or more of the following are true: 

The effective user ID of the process is super-user. 

The effective user ID of the process matches 
shm-perm.[c]uid in the data structure associated with 
shmid and the appropriate bit of the "user" portion 
(0600) of shm_perm.mode is set. 

The effective user ID of the process does not match 
shm^perm.fcjuid and the effective group ID of the process 
matches shm_perm[c]gid and the appropriate bit of the 
"group" portion (060) of shm_perm.mode is set 



00200 
00060 
00006 



Write by user. 
Read, Write by group. 
Read, Write by others. 
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The effective user ID of the process does not match 
shm-perm.fcjuid and the effective group ID of the process 
does not match shm-perm.[c]gid and the appropriate bit 
of the "other" portion (06) of shm_perm.mode is set. 

Otherwise, the corresponding permissions are denied. 



Special Processes 

The processes with a process ID of 0 and a process ID of 1 
are special processes and are referred to as procO and prod. 

ProcO is the scheduler. Prod is the initialization process (init). 
Proc 1 is the ancestor of every other process in the system 
and is used to control the process structure. 



Super-user 

A process is recognized as a super-user process and is 
granted special privileges if its effective user ID is 0. 



tty Group ID 

Each active process can be a member of a terminal group 
that is identified by a positive integer called the tty group ID. 
This grouping is used to terminate a group of related 
processes upon termination of one of the processes in the 
group (the group header); see exit. 

See Also 

apnum, devnm in Section 1 ; close, ioctl, open, pipe, read, write; 
intro in Section 3. 
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Name 



access - determines the accessibility of a file 



Format 



int access (path, amode) 
char 'path; 
int amode; 



Description 

Path points to a path name naming a file, access checks the 
named file for accessibility according to the bit pattern 
contained in amode. It uses the real user ID in place of the 
effective user ID and the real group ID in place of the 
effective group ID. The bit pattern contained in amode is 
constructed as follows: 

04 read 

02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following is true: 
[EN0TDIR] A component of the path prefix is not a directory. 



[EN0ENT] 



Read, write, or execute (search) permission is requested for 
a null path name. 



[EN0ENT] 
[EACCES] 
[ER0FS] 



Search permission is denied on a component of the path prefix. 
Write access is requested for a file on a read-only file system. 



The named file does not exist. 
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[ETXTBSY] Write access is requested for a pure procedure (shared 

text) file that is being executed. 

[EACCESS] Permission bits of the file mode do not permit the requested 

access. 

[EFAULT] Path points outside the allocated address space of the process. 

The owner of a file has access permission checked with 
respect to the owner read, write, and execute mode bits^ 
Other members of the file group have permission checked 
with respect to the group mode bits. All others have 
permission checked with respect to the other mode bits. 

Returns 

If the requested access is permitted, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

chmod, stat. 
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Name 



acct - enable or disable process accounting 



Format 



i n t acct (path) 
char 'path; 



Description 

The acct function is used to enable or disable the system 
process accounting routine. If the routine is enabled, an 
accounting record will be written on an accounting file for 
each process that terminates. Terminations can be caused by 
one of two things: an exit call or a signal; see exit and signal. 
The effective user ID of the calling process must be 
super-user to use this call. 

Path points to a path name naming the accounting file. The 
accounting file format is given in acct in Section 4. 

The accounting routine is enabled if path is non-zero and no 
errors occur during the system call. It is disabled if path is 
zero and no errors occur during the system call. 

The acct function will fail if one or more of the following are true: 
[EPERM] The effective user of the calling process is not super-user. 



[EBUSY] 



An attempt is being made to enable accounting when it is 
already enabled. 



[ENOTDIR] 
[ENOENT] 



One or more components of the accounting file path name 
do not exist. 



A component of the path prefix is not a directory. 
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[EACCES] 


A component of the path prefix denies search permission. 


[EACCES] 


The file named by path is not an ordinary file. 


[EACCES] 


Mode permission is denied for the named accounting file. 


[EISDIR] 


The named file is a directory. 


[EROFS] 


The named file resides on a read-only file system. 


[EFAULT] 


Path points to an illegal address. 


Returns 





Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

exit, signal; acct in Section 4. 
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Name 

alarm - set a process alarm clock 

Format 

unsigned alarm (sec) 
uns i gned sec ; 

Description 

The alarm system call instructs the alarm clock of the calling 
process to send the signal SIGALRM to the calling process 
after the number of real time seconds specified by sec have 
elapsed; see signal. 

Alarm requests are not stacked; successive calls reset the 
alarm clock of the calling process. 

If sec is 0, any previously made alarm request is canceled. 

Returns 

The alarm call returns the amount of time previously remaining 
in the alarm clock of the calling process. 

See Also 

pause, signal; sleep in Section 1 . 
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Name 

brk, sbrk - change data segment space allocation 



Format 

int brk (endds) 
char 'endds; 

char *sbrk ( incr) 
int incr; 



Description 

The brk and sbrk system calls are used to dynamically change 
the amount of space allocated for the data segment of the 
calling process (see exec). The change is made by resetting 
the process's break value and allocating the appropriate 
amount of space. The break value is the address of the first 
location beyond the end of the data segment. The amount of 
allocated space increases as the break value increases. The 
newly allocated space is set to zero, 
brk sets the break value to endds and changes the allocated 
space accordingly. 

sbrk adds incr bytes to the break value and changes the 
allocated space accordingly. Incr can be negative, in which 
case the amount of allocated space is decreased. 

brk and sbrk will fail without making any change in the 
allocated space if one or more of the following are true: 

o Such a change would result in more space being allocated 
than is allowed by a system-imposed maximum (see ulimit). 
Note that due to a lack of swap space this may be less 
than what ulimit reports. [ENOMEM] 

□ Such a change would result in the break value being 
greater than or equal to the start address of any attached 
shared memory segment (see shmop). 
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Returns 

Upon successful completion, brk returns a value of 0 and sbrk 
returns the old break value. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 



See Also 



exec. 
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Name 

chdir - changes the current working directory. 

Format 

i nt chd i r {path) 
char 'path; 

Description 

Path points to a path name of a directory. The chdir system 
call causes the named directory to become the current 
working directory, the starting point of path searches for 
path names not beginning with /. 

chdir fails and the current working directory is not changed if 
one or more of the following are true: 

[ENOTDIR] A component of the path name is not a directory. 

[ENOENT] The named directory does not exist. 

[EACCES] Search permission is denied for any component of the path 

name. 

[EFAULT] Path points outside the allocated address space of the process. 

Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

chroot. 
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Name 

chmod - change mode of file 

Format 

int chmod (path, mode) 
char 'path; 
int mode; 



Description 

Path points to a path name naming a file. The chmod system 
call sets the access permission portion of the named file 
mode according to the bit pattern contained in mode. 

Access permission bits are interpreted as follows: 



04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution. 

00400 Read by owner. 

00200 Write by owner. 

00100 Execute (or search if a directory) by owner. 

00070 Read, write, execute (search) by group. 

00007 Read, write, execute (search) by others. 



The effective user of the process must be the file owner or 
the super-user to change the mode of a file. 

If the effective user of the process is not the super-user, 
mode bit 01000 (save text image on execution) is cleared. 

If the effective user of the process is not super-user and the 
effective group ID of the process does not match the group 
ID of the file, mode bit 02000 (set group ID on execution) is 
cleared. 
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If an executable file is prepared for sharing, then mode bit 
01000 prevents the system from abandoning the 
swap-space image of the program-text portion of the file 
when its last user terminates. Thus, when the next user of 
the file executes it, the text does not have to be read from 
the file system. It can simply be swapped in, thus saving time. 

chmod fails and the file mode is unchanged if one or more of 
the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

[ENOENT] The named file does not exist. 

[EACCES] Search permission is denied on a component of the path prefix. 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

chown, mknod. 



[EPERM] 



[EROFS] 
[EFAULT] 



The effective user ID does not match the owner of the file 
and the effective user ID is not super-user. 

The named file resides on a read-only file system. 

Path points outside the allocated address space of the process. 
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Name 

chown - changes the owner and/or group of a file. 

Format 

int chown {path, owner, group) 

char 'path; 

int owner, group; 

Description 

Path points to a path name naming a file. The owner ID and 
group ID of the named file are set to the numeric value 
contained in owner and group, respectively. 

Only processes with an effective user ID equal to the file 
owner or the super-user may change the ownership of a file. 

If chown is invoked by other than a super-user, the set-user-ID 
and set-group-ID bits of the file mode, 04000 and 02000 
respectively, will be cleared. 

chown fails and the owner and group of the named file remain 
unchanged if one or more of the following are true: 



[ENOTDIR] 


A component of the path prefix is not a directory. 


[ENOENT] 


The named file does not exist. 


[EACCES] 


Search permission is denied on a component of the path prefix. 


[EPERM] 


The effective user 10 does not match either the owner of 




the file or the superuser. 


[EROFS] 


The named file resides on a read-only file system. 


[EFAULT] 


Part points outside the allocated address space of the process. 
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Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

chown in Section 1; chmod. 



1192192 



2-30 



System Calls 



chroot 



Name 

chroot - change the root directory. 

Format 

int chroot {path) 
char 'path; 



Description 

Path points to a path name naming a directory. The chroot 
system call causes the named directory to become the root 
directory; the starting point of path searches for path names 
beginning with /. The user's working directory is unaffected 
by the chroot system call. 

The effective user of the process must be the super-user to 
change the root directory. 

The .. entry in the root directory is interpreted to mean the 
root directory itself. Thus, .. cannot be used to access files 
outside the subtree rooted at the root directory. 

chroot fails and the root directory remains unchanged if one or 
more of the following are true: 

[ENOTDIR] Any component of the path name is not a directory. 

[ENOENT] The named directory does not exist 

[EPERM] The effective user ID is not that of the super-user. 

[EFAULT] Path points outside the allocated address space of the process. 
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Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

chdir. 
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Name 

close - close a file descriptor. 

Format 

i n t close ( f I Ides) 
i n t f i Ides ; 

Description 

Fildes is a file descriptor obtained from a creat, open, dup, fcntl, 
or pipe system call. The close system call closes the file 
descriptor indicated by fildes. 

close fails if fildes is not a valid open file descriptor. [EBADF] 

Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

creat, dup, exec, fcntl, open, pipe. 
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Name 

creat - create a new file or rewrite an existing one. 



Format 

int creat (path, mode) 
char 'path; 
Int mode; 

Description 

The creat system call creates a new ordinary file or prepares 
to rewrite an existing file named by the path name indicated 
by path. 

If the file exists, its length is truncated to 0 and the mode 
and owner are unchanged; if a PILF file, the cluster size 
exponent is also unchanged. Otherwise, the file's owner ID is 
set to the process's effective user ID, the file's group ID is 
set to the process's effective group ID, and the low-order 12 
bits of the file mode are set to the value of mode and 
modified as follows: 

□ All bits set in the process's file mode creation mask are 
cleared. See umask. 

a The "save text image after execution bit" of the mode is 
cleared. See chmod. 

The process's cluster size exponent determines the cluster 
size of files created on PILF file systems. See syslocal. 

Upon successful completion, the file descriptor, which is a 
non-negative integer, is returned and the file is opened for 
writing, even if the mode does not permit writing. The file 
pointer is set to the beginning of the file. The file descriptor 
is set to remain open across exec system calls. See fcntl. No 
process may have more than 20 files open simultaneously. A 
new file may be created with a mode that forbids writing. 
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creat fails if one or more of the following are true: 



[ENOTDIR] 


A rnmnnnPFlt nf thfl nath nrafiv ic nnt a Hiran+nrw 

" ounipunciii ui liic pain pic MA 15 IIUL d U lie CI Dry. 


IXAinCKITl 

IcNUblMI J 


A component of the path prefix does not exist. 


[EACCES] 


Search permission is denied on a component of the path prefix. 


[ENOENT] 


The path name is null. 


[EACCES] 


The file does not exist and the directory in which the file is 




to be created does not permit writing. 


rconcci 


The named file resides or would reside on a read-only file 




system. 


[ETXTBSY] 


The file is a pure procedure (shared text) file that is being 




executed. 


[EACCES] 


The file exists and write permission is denied. 


[EISDIR] 


The named file is an existing directory. 


[EMFILE] 


Twenty file descriptors are currently open. 


[EFAULT] 


PathpoMs outside the allocated address space of the process. 


[ENFILE] 


The system file table is full. 


Returns 





Upon succesful completion, a non-negative integer, namely 
the file descriptor, is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 

See Also 

chmod, close, dup, fcntl, locking, Iseek, open, read, umask, write. 
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Name 

dup - duplicate an open file descriptor. 

Format 

i n t dup ( / / Idas) 
i n t 11 1 des; 

Description 

Fildes is a file descriptor obtained from a creat, open, dup, fcntl, 
or pipe system call. The dup system call returns a new file 
descriptor having the following in common with the original: 

□ Same open file (or pipe). 

□ Same file pointer (that is, both file descriptors share one 
file pointer). 

□ Same access mode (read, write or read/write). 

The new file descriptor is set to remain open across exec 
systems calls. See fcntl. 

The file descriptor returned is the lowest one available, 
dup fails if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[EMFILE] 20 file descriptors are currently open. 

Returns 

Upon successful completion, a non-negative integer, namely 
the file descriptor, is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 

See Also 

creat, close, exec, fcntl, open, pipe. 
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Name 

exAllocExch - allocate exchange 

Format 

#i nc I ude <exch . h> 

unsigned char exAllocExch (); 

Description 

See Exchanges. 



System Calls 



2-37 



exCall 



Name 

exCall - send a request and wait for the response 



Format 

#include <exch.h> 

exCall (.reqbl): 

struct reqheader 'reqbl; 

Description 

The exCall system call sends a request and waits for the 
response. Reqbl must point to a request block that describes 
the message. The request block has four parts: a request 
header, control information, request PbCbs, and response 
PbCbs. 

The ICC user include file defines a request header in the 
following way: 

struct rqheader { 

unsigned short r_sCntlnfo; 
unsigned char r_nHeqPbCb; 
unsigned char r_nRespPbCb; 
unsigned short r_userNum; 
unsigned short r_exchResp; 
unsigned short r_ercRet: 
unsigned short r_rqCode; 

} ; 

The client sets the following fields: r^sCntlnfo (which must be 
even), r^nReqPbCb, and r-nRespPbCb specify the size of the 
rest of the request block; r^exchResp specifies where the 
response must be sent; and rjrqCode specifies the 
destination of the request. The kernel and server ignore any 
values in rjJserNum or rjercRet. Each request code requires 
specific values for rsCntlnfo, ruiReqPbCb, and r^iRespPbCb. 
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The client uses the control information to send fixed-lenqth 
data fields to the server. 

A PbCb has the following structure: 

struct PbCb { 

char *pc_offset; 
unsigned short pc_count; 

The client uses Request PbCbs to send blocks of data to the 
server. Each PbCb gives the location [pc-offset) and size 
ipc-count) of a data block. 

The client uses Response PbCbs to pass response data 
areas {pc-offset) and maximum lengths (pc^count) to the 
server and kernel. If the server ignores the restrictions the 
kernel right-truncates the offending fields. 

The memory containing the variable-length fields need not 
immediately follow the request block. 



Returns 

-1 indicates an error, with an error code in errno. See nerror ii 
Section 3. 



Cautions 

If the service is provided by BTOS, integer data must have 
Intel byte ordering. See shortswap in Section 3. 

The lint shell command may complain that exCall argument 
types are inconsistent, especially if the client uses more than 
one kind of request block. To suppress these complaints 
cast the argument to its official type: 

exCall((struct rqheader*) reqbl); 

Use of this cast does not affect the object code. 
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If an exCall is being used by a program that also traps signals, 
users must beware when a -1 is returned with errno equal to 
EINTR. In this case, the exCall has effectively done an 
exRequest. The user must then do an exWait and an 
exCpResponse (and correctly handle the interrupted exWait by 
restarting it). Otherwise, your program will lose one of its 
responses and will consume valuable kernel heap space to 
hold the response until your program exits. 

See Also 

exchanges in the XE 500 CENTIX Programming Guide 



1192192 



2-40 



System Calls 



exchanges 

Name 

exAllocExch, exDeallocExch - obtain and abandon exchanges. 

Format 

# i no I ude <exch . h> 

unsigned char exAllocExch (); 

exOea I locExch ( ex) 
unsigned char ex; 

Description 

A process must own exchanges in order to receive 
messages. Each exchange has an exchange descriptor, which 
is unique to the owner of the exchange. 

exAllocExch allocates a new exchange and returns its exchange 
descriptor. The calling process can use this exchange to 
receive both requests and responses. 

exDeallocExch deallocates the specified exchange. Any 
requests still waiting or on their way to the exchange are 
rejected with a return code of OxFF. Any responses still 
waiting or on their way to the exchange are discarded. 

A process's death deallocates all its exchanges, but an exec 
has no effect on exchanges. 

Returns 

-1 indicates error, with an error code in errno. See perror in 
Section 3. 
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Name 

exCheck - examine an ICC message queue 

Format 

# i nc I udo <exch . h> 

exCheck ( ex , ms tat) ; 
unsigned char ex; 
struct msgret 'mstat; 

Description 

See exWait. 
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Name 

exCnxSendOnDealloc - make final requests 

Format 

#include <exch.h> 

exCnxSendOnDealloc ( req) 
unsigned short req; 

Description 

See exfinal. 
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Name 

exCpRequest, exReject - remove a request from an exchange. 

Format 

^include <exch.h> 

exCpRequest (reqdes, reqst) 
unsigned short reqdes; 
struct rqheader 'reqst; 

exReject (reqdes, r_ercRet) 
unsigned short reqdes: 
unsigned short r_ercRet; 



Description 

The exCpRequest and exReject system calls both remove a 
request from a server's exchange. A server that wants to 
examine the request uses exCpRequest; a server that has no 
interest in the message's contents uses exReject. 

exCpRequest copies the message indicated by the request 
descriptor, reqdes. The kernel places the request block and 
request data blocks together at the location pointed to by 
reqst. Reqst must be an even address; each data block 
appears at an even address. (The amount of memory the 
message requires is returned by a check on the message 
queue; see exWait.) The kernel sets the request PbCbs to 
point to the server's copies of the data blocks. 

exReject discards the contents of the indicated message. It 
sends the response, with the return code (m-ercRet in the 
request block header) set to ruercRet. 
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Returns 

-1 indicates error, with an error code in errno. See perror in 
Section 3. 

Files 

/usr/include/exch.h - ICC user include file 
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Name 

exCpResponse, exDiscard - remove a response from an 
exchange. 

Format 

#lnclude <exch.h> 

exCpResponse {reqdes, reqst) 
unsigned short reqdes; 
struct rqheader 'reqst; 

exDiscard ( reqdes) 
unsigned short reqdes; 



Description 

The exCpResponse and exDiscard system calls both remove a 
response from an exchange. A client that wants to examine 
the response uses exCpResponse; a client that has no interest 
in the message's contents uses exDiscard. 

exCpResponse copies the message indicated by the request 
descriptor reqdes. The kernel uses the request block pomtec 
to by reqst to place the parts of the response: 
o The error code goes in the ruercRet field of the request 
block header. 

□ The kernel examines each response PbCb in the request 
block The pcoffset field should be set to the location 
reserved for the data; pcucount should be set to the 
number of bytes available at that location. If the server 
provided more than pcjcount bytes, the kernel 
right-truncates the data to fit. The kernel overwrites 
pa-count with the number of bytes actually transferred. 
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exDiscard discards the contents of the indicated message. It 
returns the message's return code field (m^ercRet in the 
request block header). 

Returns 

-1 indicates error, with an error code in errno. See nerror in 
Section 3. 

Caution 

If the service is provided by BTOS, integer data has Intel 
byte ordering. See shortswap in Section 3. 

Files 

/usr/include/exch.h - ICC user include file. 
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Name 

exDeallocExch - deallocate exchange 

Format 

#include <exch.h> 

exOaa I I ocExch ( sx) 
unsigned char ex; 

Description 

See Exchanges. 
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Name 

exDiscard - remove a response from an exchange 

Format 

# i nc I ude <exch . h> 

exDiscard ( reqdes) 
unsigned short reqdes; 



Description 

See exCpResponse. 
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Name 

execl, execv, execle, execve, execlp, execvp - execute files 



Format 

int execl {path, argO, arg1 , 
char 'path, 'argO, 'argl, ■■ 

int execv (path, argv) 
char 'path, 'argv[\; 

int execle (path. argO. argt argn, 0. envp) 

char 'path, 'argO, 'argl 'argn, envpl]; 

Int execve (path, argv, envp) 

char 'tile, 'argO, 'argl 'argn; 

int execlp (file, argO, argl argn, 0) 

char 'file. 'argO, 'argl 'argn; 

i n t execvp (file, a rgv) 
char -tile, 'argv\] 



.... argn, 0) 
. , 'argn; 



Description 

The exec system call in all its forms transforms the calling 
process into a new process. The new process is constructed 
from an ordinary, executable file called the new process file. 
This file consists of a header (see a.out in Section 4). a text 
segment, and a data segment. The data segment contains an 
initialized portion and an uninitialized portion (bss). There can 
be no return from a successful exec because the calling 
process is overlaid by the new process. 
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When a C program is executed, it is called as follows: 

main (argc, argv, envp) 
i nt argc ; 

char ''argv, "envp; 

where argc is the argument count and argv is an array of 
character pointers to the arguments themselves. As 
indicated, argc is conventionally at least 1 , and the first 
member of the array points to a string containing the name 
of the file. 

Path points to a path name that identifies the new process file. 
File points to the new process file. The path prefix for this 
tile is obtained by a search of the directories passed as the 
environment line "PATH=" (see environ in Section 5) The 
environment is supplied by the shell (see sh in Section 1). 

ArgO, argl argn are pointers to null-terminated character 
strings. These strings constitute the argument list available 
to the new process. By convention, at least argO must be 
present and point to a string that is the same as path (or its 
last component). 

Argv is an array of character pointers to null-terminated 
strings. These strings constitute the argument list available 
to the new process. By convention, argv must have at least 
one member, and it must point to a string that is the same 
as path (or its last component). Argv is terminated by a null 
pointer. 

Envp is an array of character pointers to null-terminated 
strings. These strings constitute the environment for the new 
process. Envp is terminated by a null pointer. For execl and 
execv, the C run-time start-off routine places a pointer to the 
environment of the calling process in the global cell: 

extern char "environ; 

and is used to pass the environment of the calling process to 
the new process. 
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File descriptors opened in the calling process remain open in 
the new process, except for those whose close-on-exec flag 
is set; see fcntl. For those file descriptors that remain open, 
the file pointer is unchanged. 

Signals set to terminate the calling process are set to 
terminate the new process. Signals set to be ignored by the 
calling process are set to be ignored by the new process. 
Signals set to be caught by the calling process are set to 
terminate the new process. See signal. 
If the set-user-ID mode bit of the new process file is set (see 
chmod), exec sets the effective user ID of the new process 
equal to the owner ID of the new process file. Similarly, if the 
set-group-ID mode bit of the new process file is set, the 
effective group ID of the new process is set to the group ID 
of the new process file. The real user ID and real group ID ot 
the new process remain the same as those of the calling 
process. 

Profiling is disabled for the new process; see profil. 

The new process also inherits the following attributes from 

the calling process: 

nice value (see nice) 
process ID 
parent process ID 
process group ID 

ICC exchanges, with unremoved messages addressed to 
them 

semadj values (see semop) 

tty group ID (see exit and signal) 

trace flag (see ptrace request 0) 

time left until an alarm clock signal (see alarm) 

current working directory 

root directory 

file mode creation mask (see umask) 
file size limit (see ulimit) 
utime, stime, cutime, and cstime (see times) 
PILF cluster size exponent for this process 
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An exec fails and returns to the calling process if one or more 
of the following are true: 



[ENOENT] 

[ENOTDIR] 

[EACCES] 

[EACCES] 
[EACCES] 
[ENOEXEC] 

[ETXTBSY] 

[ENOMEM] 

[E2BIG] 

[EFAULT] 

[EFAULT] 

Returns 



One or more components of the new process file path name 
do not exist. 

A component of the new process file path prefix is not a 
directory. 

Search permission is denied for a directory listed in the new 
process file path prefix. 

The new process file is not an ordinary file. 

The new process file mode denies execution permission. 

The exec is not an execlp or execvp, and the new 

process file has the appropriate access permission but an 
invalid magic number in its header. 

The new process file is a pure procedure (shared text) file 
that is currently open for writing by some process. 

The new process requires more memory than is allowed by 
the system-imposed maximum MAXMEM. 

The number of bytes in the new process argument list is 
greater than the system-imposed limit of 10,240 bytes. 

The new process file is not as long as indicated by the size 
values in its header. 

path, argv, or envp point to an illegal address. 



If exec returns to the calling process, an error has occurred; 
the return value will be -1 and errno will be set to indicate the 
error. 



See Also 

sh in Section 1 , alarm, exit, fork, nice, ptrace, semop, signal, 
times, ulimit, umask; a.out in Section 4; environ in Section 5. 
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Name 

execl - execute files 

Format 

Int execl (path, argO, argl argn, 

char •path, 'argO, "argl 'argn; 

Description 

See exec. 
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Name 

execle - execute a file 

Format 

int execle [path, argO. argl argn, 0, envp) 

char 'path, 'argO, 'argl 'argn, 'envp[]\ 

Description 

See exec. 
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Name 

execlp - execute a file 

Format 

int execlp (file. argO, argl argn, 

char 'file, 'argO, 'argl 'argn; 

Description 

See exec. 
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Name 

execv - execute a file 

Format 

int execv (path, argv) 
cha r 'path, ' argv[ J ; 



Description 

See exec. 
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Name 

execve - execute a file 

Format 

int execve (path, argv, envp) 
char 'path, 'argv[], 'envpi]: 

Description 

See exec. 
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Name 

execvp - execute a file 

Format 

i n t execvp (file, argv) 
char 'tile. • argv[ ] ; 

Description 

See exec. 
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Name 

exSendOnDealloc, exCnxSendOnDealloc - make final requests. 

Format 

# I nc I ude <exch . h> 

unsigned short exSendOnDsal loo (reqblk) 
struct reqheader "reqblk; 

a xCnxSe n cOnDe a I loc ( req) 
uns i gned short req; 

Description 

The exSendOnDealloc system call specifies a request and 
returns a request descriptor in precisely the same manner as 
exRequest. But where exRequest dispatches the request 
immediately, exSendOnDealloc puts a hold on the request. 
When the client process deallocates the request's response 
exchange (either by dying or by a call to exDealloc; see 
exchanges), the kernel delivers the message. 

The exCnxSendOnDealloc system call cancels the specified 
message. Req must be a value returned by a call to 
exSendOnDealloc. 

Returns 

-1 indicates error, with an error code in ermo. See perror in 
Section 3. 
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Cautions 

The server must respond to the message, even though there 
is no one to read the response. 

Files 

/usr/include/exch.h - ICC user include file 
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Name 

exit, _exit - terminate process 

Format 

void exit {status) 
i n t status; 
void _exit {status) 
i n t st a tus; 

Description 

The exit system call terminates the calling process with the 
following consequences: 

a All of the file descriptors opened in the calling process are 
closed. 

□ If the parent process of the calling process is executing a 
wait, it is notified of the calling process termination and the 
low order eight bits (that is, bits 0377) of status are made 
available to it; see wait. 

□ If the parent process of the calling process is not executing 
a wait, the calling process is transformed into a zombie 
process. A zombie process is a process that occupies a 
slot only in the process table; it has no other space 
allocated either in user or kernel space. The process table 
slot that it occupies is partially overlaid with time 
accounting information (see <sys/proc.h>) to be used by times. 

□ The parent process ID is set to 1 for all of the child 
processes and zombie processes created by the calling 
process. This means the initialization process inherits each 
of these processes. 

□ All ICC exchanges are deallocated. This is the only way to 
deallocate the default response exchange. 

□ If the process ID, tty group ID, and process group ID of the 
calling process are equal, the SIGHUP signal is sent to each 
process that has a process group ID equal to that of the 
calling process. 
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The C function exit may cause cleanup actions before the 
process exits. The function _exit circumvents all cleanup. 

See Also 

acct, intra, exchanges, semop, signal, wait. 
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Name 

exReject - remove a request from an exchange 

Format 



# i nc I ude 



<exch . h> 



exRe j ec t 
uns i gned 
uns i gned 



[reqdes, r_ercRat) 
short reqdes: 
sho r t r_ercRe t ; 



Description 



See exCpRequest. 
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Name 

exRequest - send a message to a server 

Format 

#include <exch.h> 

unsigned short exRequest {reqbl); 
struct reqheader "reqbl; 

Description 

The exRequest system call sends a message to a server, reqbl 
points to a request block that describes the message. 
exRequest returns a request descriptor; this descriptor appears 
in subsequent references to the request by the client or the 
kernel. 

The request block has four parts: a request header, control 
information, request PbCbs, and response PbCbs. 

A request header has the following structure. 

struct rqheader { 

unsigned short r_sCntlnfo; 
unsigned char r_nReqPbCb; 
unsigned char r_nRespPbCb; 
unsigned short r_userNum; 
unsigned short r_exchResp; 
unsigned short r_ercRet; 
unsigned short r_rqCode; 

} ; 
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The client sets the following fields: r^sCntlnfo (which must be 
even), rjnReqPbCb, and r^nRespPbCb specify the size of the 
rest of the request block; ruexchResp specifies where the 
response must be sent; and rurqCode specifies the 
destination of the request. The kernel and server ignore any 
values in r-userNum or r^ercRet. Each request code requires 
specific values for rsCntlnfo, rjnReqPbCb, and r-nRespPbCb. 

The client uses the control information to send fixed-length 
data fields to the server. 

A PbCb has the following structure: 

struct PbCb { 

char *pc_of f set ; 
unsigned short pc_count; 

}: 

The client uses Request PbCbs to send request data blocks 
to the server. Each PbCb gives the location {pc-offset) and 
size [pc-Count) of a data block. 

The client uses Response PbCbs to pass response 
data-length restrictions to the server. The client sets the 
pc-COunt field of each response PbCb to the maximum length 
for that data block. 

The locations containing the client request data need not 
immediately follow the request block. 

The kernel copies the complete message immediately. Once 
exRequest returns, it is safe to modify the message. 

After the client has sent the request, it must watch for the 
corresponding response (exWait) and specify the response's 
disposition (exCpResponse) 
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Returns 

-1 indicates error, with an error code in errno. See perror in 
Section 3. 

Cautions 

Use of exRequest requires more client-kernel interaction than is 
necessary for most requests. Compare exCall. 

If the service is provided by BTOS, integer data must have 
Intel byte ordering. See shortswap in Section 3. 

The lint compiler may complain the exRequest argument types 
are inconsistent, especially if the client uses more than one 
kind of request block. To suppress these complaints, cast 
the argument to its official type: 

exRequest((struct rqheader *) reqbl); 

Use of this cast does not affect the object code. 
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Name 

exRespond - send a message to a client 

Format 

#include <exch.h> 

exRespond (reqdes, reqbl) 
unsigned short reqdes; 
struct reheader 'reqbl; 

Description 

The exRespond system call issues a response to a specific 
request. The request descriptor reqdes specifies that request. 
reqbl points to a request block that dsecribes the response. 
This request block has the same format as the request block 
that described the request (see exRequest). The server sets 
only the error return code fields and each of the response PbCbs. 

The kernel copies the complete message immediately. Once 
exRespond returns, it is safe to modify the message. 

The memory containing the server's variable-length response 
fields need not directly follow the request block. 

Returns 

-1 indicates error, with an error code in errno. See perror in 
Section 3. 
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Name 

exSendOnDealloc - make final requests 

Format 

#include <exch.h> 

unsigned short exSendOnDealloc (reqblk) 
struct rqheader 'reqblk; 

Description 

See exfinal 
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Name 

exServeRq - appropriate a request code 

Format 

#include <axch.h> 

exServeRq {exch, code); 
unsigned char exch; 
unsigned short code; 



Description 

A server (a process that receives requests) must own a 
request code for use by clients (processes that send 
requests). exServeRq appropriates code as a request code and 
assigns the request to the exchange specified by exch. If 
exch is zero, the process gives up code, which can then be 
appropriated by another server. 

Any process can appropriate a request code, but only one 
can own it at a time. 

Codes 0 through OxBFFF (49151) are reserved for Burroughs 
system services. Each installation should reserve additional 
codes for local system services. User services must not use 
reserved codes, even if they do not currently identify a service. 



Returns 

-1 indicates error, with an error code in errno. See perror in 
Section 3. 
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Name 

exWait, exCheck - examine an ICC message queue. 

Format 

^Include <exch.h> 

exWa it [ex , ms tat) ; 
uns i gned char ex; 
struct msg r e t 'ms ta t ; 

exCheck (ex, mstat); 
unsigned char ex; 
struct msg r e t 'mstat ; 

Description 

Each call to exWait or exCheck returns with information on the 
oldest unnoticed message waiting at the exchange whose 
descriptor is ex. An unnoticed message is one that exWait 
and exCheck have not reported on since the last time a 
message was removed from the exchange. When an 
exchange's owner removes a message, all messages still 
waiting become "unnoticed" again; see exCpResponse and 
exCpRequest. exCall never affects the "noticed" status of any 
message. 

exWait and exCheck write a report to the memory pointed to 
by mstat. The report has the following structure: 

struct msgret { 

unsigned short m_rqCode; 
unsigned short m_reqdes; 
i n t m_s i ze ; 
char m_ flag; 

unsigned short m_ercRet; 
unsigned char m_c p u t y p e ; 
unsigned char m_s lot; 
struct request *m_otfset; 

) ; 
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When the process takes further action on this message 
(copying it from the message queue; if it's a request, sending 
a response) it passes the kernel mjreqdes to identify the 
specific message. 

exWait and exCheck differ only in their "no messages" action. If 
no unnoticed messages wait at the specified exchange, 
exWait waits for a new one to arrive; exCheck returns 
immediately with an error code. 

The calling process must specify some action on each 
message. See exCpResponse and exCpRequest. 

Returns 

If exWait or exCheck terminate unsuccessfully, a value of -1 is 
returned and errno is set to indicate the error. 
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Name 

fcntl - file control 



Format 

#1 no I ude <f cn t I . h> 

int fcntl (fildes, cmd, arg) 
I n t tildes, cmd , arg ; 



Description 

The fcntl system call provides for control over open files. 
Fildes is an open file descriptor obtained from a creat, open, 
dup, fcntl, or pipe system call. 

The commands available are: 

Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or 
equal to arg. 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (that is, both file 
descriptors share one file pointer). 

Same access mode (read, write or read/write). 

Same file status flags (that is, both file descriptors share 
the same file status flags) 

The close-on-exec flag associated with the new file 
descriptor is set to remain open across exec system calls. 

Get the close-on-exec flag associated with the file descriptor 
fildes. If the low-order bit is 0, the file remains open across 
exec; otherwise the file is closed upon execution of exec. 

Set the close-on-exec flag associated with fildes to the 
low-order bit of arg (0 or 1 as above). 



FJJUPFD 



FJ3ETFD 
F_SETFD 
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Get file status flags. 

Set file status flags to arg. Only certain flags can be set. 
See fcntl in Section 5. 

Get the first lock that blocks the lock description given by 
the variable of type struct flock pointed to by arg. The 
information retrieved overwrites the information passed to 
fcntl in the flock structure. If no lock is found that would 
prevent this lock from being created, then the structure is 
passed back unchanged except for the lock type (which will 
be set to F_UNLCK). 

Set or clear a file segment lock according to the variable of 
type struct flock pointed to by arg (see fcntl in Section 
5). The command F_SETLK is used to establish read 
(F-RDLCK) and write (F_WRLCK) locks, as well as to 
remove either type of lock (FJJNLCK). If a read or write 
lock cannot be set, fcntl will return immediately with an 
error value of -1 . 

F_SETLKW This is the same as F_SETLK, except that if a read or 

write lock is blocked by other locks, the process will sleep 
until the segment is free to be locked. 

A read lock prevents any process from write-locking the 
protected area. More than one read lock may exist for a 
given segment of a file at a given time. The file descriptor on 
which a read lock is being placed must have been opened 
with read access. 

A write lock prevents any process from read-locking or 
write-locking the protected area. Only one write lock may 
exist for a given segment of a file at a given time. The file 
descriptor on which a write lock is being placed must have 
been opened with write access. 

The structure flock describes the type (Ltype), starting offset 
(Lwhence), relative offset (/_sfa/t), size (Uen), and process id 
(l-pid) of the segment of the file to be affected. The process 
id field is used only with the F_GETLK command to return the 
value for a blocking lock. Locks may start and extend beyond 
the current end of a file, but may not be negative relative to 
the beginning of the file. A lock may be set to always extend 
to the end of file by setting Uen to zero. 



fcntl 

F-GETFL 
F-SETFL 

F-GETLK 
F_SETLK 
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If such a lock also has l^start set to zero, the whole file will 
be locked. Changing or unlocking a segment from the middle 
of a larger locked segment leaves two smaller segments for 
either end. Locking a segment that is already locked by the 
calling process causes the old lock type to be removed and 
the new lock type to take affect. All locks associated with a 
file for a given process are removed when a file descriptor 
for that file is closed by that process or the process holding 
that file descriptor terminates. Locks are not inherited by a 
child process in a fork system call. 

The fcntl call fails if one or more of the following are true: 

[EBADF] Rides is not a valid open file descriptor. 

[ EMFILE J Cmd is F-DUPFD and 20 file descriptors are currently open. 

t EMFILE ] Cmd is F_SETLK or F_SETLKW, the type of lock is a read 

or write lock and there are no more file-locking headers 
available (too many files have segments locked).D 

[EINVAL] Cmd is FJ3UPFD and arg is negative, greater than or equal 

to 20. 

[EINVAL] Cmd is F_GETLK, F_SETLK, or F_SETLKW and arg or the 

data it points to is not valid. 

[EACCES] Cmd is F_SETLK, the type of lock [Ltype) is a read 

(F_RDLCK) or write (F_WRLCK) lock, and the segment of a 
file to be locked is already write-locked by another process, 
or the type is a write lock and the segment of a file to be' 
locked is already read- or write-locked by another process. 

[ENOSPC] Cmd is F_SETLK or F_SETLKW, the type of lock is a read 

or write lock and there are no more file-locking headers 
available (too many files have segments locked), or there 
are no more record locks available (too many file segments 
locked). 

[EDEADLK] Cmd is F_SETLK, when the lock is blocked by some lock 

from another process and sleeping (waiting) for that lock to 
become free; this causes a deadlock situation. 
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Returns 

Upon successful completion, the value returned depends 
cmd as follows: 



F-DUPFD A new file descriptor. 

FJ5ETFD The value of flag (only the low-order bit is defined). 

F_SETFD A value other than -1. 

F-GETFL The value of file flags. 

F-SETFL A value other than -1. 

F-GETLK A value other than -1 . 

F_SETLK A value other than -1. 

F-SETLKW A value other than -1. 



Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

close, exec, open; fcntl in Section 5. 
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Name 

fork - create a new process. 

Format 

Int fork ( ) 



Description 

The fork system call causes creation of a new process The 
new process (child process) is an exact copy of the calling 
process (parent process). This means the child process 
inherits the following attributes from the parent process- 
environment 

close-on-exec flag (see exec) 

signal handling settings (such as SIG_DFL, function 

address) 

set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice) 
process group ID 
tty group ID (see exit) 
current working directory 
root directory 

file mode creation mask (see umask) 
file size limit 

PILF cluster size exponent (see pilf in Section 5) 

The child process differs from the parent process in the 
following ways: 

□ The child process has a unique process ID. 

d The child process has a different parent process ID (the 
process ID of the parent process). 

□ The child process has its own copies of its parent process 
file descriptors. Each child process file descriptor shares a 
common file pointer with the corresponding file descriptor 
of the parent. 
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□ The child process inherits no ICC exchanges from the 
parent. Initially, the child's only exchange is the default 
response exchange. 

The fork call fails and no process is created if one or more of 
the following are true: 



Returns 

Upon successful completion, fork returns a value of 0 to the 
child process and returns the process ID of the child process 
to the parent process. Otherwise, a value of -1 is returned to 
the parent process, no child process is created, and errno is 
set to indicate the error. 



See Also 

exchanges, exec, nice, plock, ptrace, semop, shmop, signal, times, 
ulimit, umask, wait. 



[EAGAIN] 



[EAGAIN] 



The system-imposed limit on the total number of processes 
under execution would be exceeded. 

The system-imposed limit on the total number of processes 
under execution by a single user would be exceeded. 



[EXFULL] 



A default response exchange cannot be allocated for the 
process. 
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Name 

fstat - get file status 

Format 

#include <sy s / t ypas . h> 
#includa <sys/stat.h> 

Int fstat (tildes, but) 

int tildes; 

st ruct stat 'but; 



Description 

See stat. 
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Name 

getegid - get effective group ID 

Format 

unsigned short getegid () 

Description 

See getuid. 
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Name 

geteuid - get effective user ID 

Format 

unsigned short geteuid () 

Description 

See getuid. 
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Name 

getgid - get real group ID 

Format 

unsigned short getgid ( 

Description 

See getuid. 
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Name 

getpgrp - get process group ID 

Format 

int getpgrp () 

Description 

See getpid. 
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Name 

getpid, getpgrp, getppid - get process, process group, and 
parent process IDs 

Format 

int getp i d ( ) 
int getpgrp () 
int getppid () 

Description 

The getpid system call returns the process ID of the calling 
process. 

getpgrp returns the process group ID of the calling process, 
getppid returns the parent process ID of the calling process. 

See Also 

exec, fork, intro, setpgrp, signal. 
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Name 

getppid - get parent process ID 

Format 

int getppid () 

Description 

See getpid. 



System Calls 



2-85 



getuid 

Name 

getuid, geteuid, getgid, getegid - get real user, effective user, 
real group, and effective group IDs 

Format 

unsigned short getuid () 
unsigned short geteuid () 
unsigned short getgid () 
unsigned short getegid () 

Description 

The getuid call returns the real user ID of the calling process. 
The geteuid call returns the effective user ID of the calling 
process. 

getgid returns the real group ID of the calling process, 
getegid returns the effective group ID of the calling process. 

See Also 

intra, setuid. 



1192192 



2-86 



System Calls 



ioctl 



Name 

ioctl - control device 

Format 

ioctl (Hides, request, arg) 
Int tildes, request; 



Description 

The ioctl system call performs a variety of functions on 
character special files (devices). The write-ups of various 
devices in Section 6 discuss how ioctl applies to them. 

ioctl will fail if one or more of the following are true: 

[EBADF] Fildes is not a valid open file descriptor. 

[ENOTTY] Fildes is not associated with a character special device. 

[EINVAL] Request or arg is not valid. See Section 6. 

[EINTR] A signal was caught during the ioctl system call. 

Returns 

If an error has occurred, a value of -1 is returned and errno is 
set to indicate the error. 



See Also 

termio in Section 6. 
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Name 



kill 



- send a signal to a process or a group of processes 



Format 



i n t kill ( p i d , sig) 
i n t p i d , sig; 



Description 

The kill system call sends a signal to a process or a group of 
processes. The process or group of processes to which the 
signal is to be sent is specified by pid. The signal that is to 
be sent is specified by sig. which can be 0 or one from the 
list given in signal. 

If sig is 0 (the null signal), error checking is performed but no 
signal is actually sent. This can be used to check the validity 
of pid. 

The real or effective user ID of the sending process must 
match the real or effective user ID of the receiving process, 
unless the effective user ID of the sending process is super-user. 

The processes with a process ID of 0 and a process ID of 1 
are special processes (see intra) and will be referred to below 
as procO and prod , respectively. 

If pid is greater than zero, sig is sent to the process whose 
process ID is equal to pid. Pid may equal 1 . 
If pid is 0, sig is sent to all processes (excluding procO and 
prod) whose process group IDs are equal to the process 
group ID of the sender. 

If pid is -1 and the effective user ID of the sender is not that 
of the super-user, sig is sent to all processes (excluding 
procO and prod) whose real user IDs are equal to the 
effective user ID of the sender. 
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\1p/d is -1 and the effective user ID of the sender is that of 
the super-user, sig is sent to all processes excludinq procO 
ana prod. aA ^ 

If pid \s negative but not -1, sig is sent to all processes 
whose process group ID is equal to the absolute value of pid. 

The kill call fails and no signal is sent if one or more of the 
following are true: 

[EINVAL] sig is not a valid signal number. 

[EINVAL] Sl g j s SIGKILL and pid is 1 {prod). 

[ESRCH] No process can be found corresponding to that specified by pid. 

[EPERM] The user 'D of the sending process is not super-user and 

its real or effective user ID does not match the real or 
effective user ID of the receiving process. 



Returns 

Upon successful completion, a value of 0 is returned 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

kill in Section 1 ; getpid, setpgrp, signal. 
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Name 

link - link to a file 

Format 

i nt link ( pa t h 1 , path2) 
char 'pathl, 'path2\ 

Description 

Path 1 points to a path name of an existing file. Pathl points 
to a path name of the new directory entry to be created. The 
link system call creates a new link (directory entry) for the 
existing file. 

The link call fails and no link is created if one or more of the 
following are true: 



[ENOTDIR] A component of either path prefix is not a directory. 

[ENOENT] A component of either path prefix does not exist. 

[EACCES] A component of either path prefix denies search permission. 

[ENOENT] The file named by pathl does not exist. 

[EEXIST] The link named by path2 exists. 

[EPERM] The file named by pathl is a directory and the effective 

user ID is not super-user. 

[EXDEV] The link named by path2 and the file named by pathl are 

on different logical devices (file systems). 

[ENOENT] Path2 points to a null path name. 

[EACCES] The requested link requires writing in a directory with a 

mode that denies write permission. 

[EROFS] The requested link requires writing in a directory on a 

read-only file system. 

[EFAULT] Path points outside the allocated address space of the process. 

[EMLINK] The maximum number of links to a file would be exceeded. 
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Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

unlink. 
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Name 

locking - exclusive access to regions of a file 

Format 

i n t locking (filedes, mode, size); 
int filedes, mode; 
I ong size; 

Description 

The locking system call places or removes an advisory lock on 
a region of a file. 

Parameters specify the file to be locked or unlocked, the kind 
of lock or unlock, and the region affected: 

o Filedes specifies the file to be locked or unlocked. It is a file 
descriptor returned by an open, creat, pipe, fcntl, or dup 
system call 

□ Mode specifies the action: 0 for lock removal, 1 for 
blocking lock, 2 for checking lock. Blocking and checking 
locks differ only if the attempted lock is itself locked out: a 
blocking lock waits until the existing lock or locks are 
removed; a checking lock immediately returns an error. 

□ The region affected begins at the current file offset 
associated with filedes and is size bytes long. If size is zero, 
the region affected ends at the end of the file (size should 
be positive). 

Locking imposes no structure on a CENTIX file. A process 
can arbitrarily lock any unlocked byte and unlock any locked 
byte However, creating a large number of noncontiguous 
locked regions can fill up the system's lock table and make 
further locks impossible. It is advisable that a program's use 
of the locking call segment the file in the same way as does 
the program's use of a read and write. 
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A process is said to be deadlocked if it is sleeping until an 
unlocking which is indirectly prevented by that same sleeping 
process. The kernel will not permit a blocking locking if such a 
call would deadlock the calling process. Errno is set to 
EDEADLOCK. The standard response to such a situation is 
for the program to release all its existing lock areas and try 
again. If a locking call fails because the kernel's table of locked 
areas is full, again, errno is set to EDEADLOCK and, again, the 
calling program should release its existing locked areas. 

Special files and pipes can be locked, but no input/output is 
blocked. 

Locks are automatically removed if the process that placed 
the lock terminates or closes the file descriptor used to place 
the lock. 



Returns 

A return value of -1 indicates an error, with the error value in 



Caution 

Do not apply any standard input/output library function to a 
locked file: this library does not know about locking. 

The lock is purely advisery. Users who wish to can still read 
write, creat, and open the file. The locking system call is the on'l 
system call that checks locks. 



See Also 



errno. 



[EACCES] 
[EDEADLOCK] 



A checking lock on a region already locked. 

A lock that would cause deadlock or overflow the system's 
lock table. 



creat, close, dup, open, read, write. 
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Name 



Iseek - move read/write file pointer 



Format 



long Iseek (fildes, offset, whence) 



i n t / / Ides ; 
I ong offset; 
int whence: 



Description 

Fildes is a file descriptor returned from a creat, open, dup, or 
fcntl system call. The Iseek system call sets the file pointer 
associated with fildes as follows: 

□ If whence is 0, the pointer is set to offset bytes. 

□ If whence is 1 , the pointer is set to its current location plus 
offset. 

a If whence is 2, the pointer is set to the size of the file plus 



Upon successful completion, the resulting pointer location, as 
measured in bytes from the beginning of the file, is returned. 

Iseek will fail and the file pointer will remain unchanged if one 
or more of the following are true: 



offset. 



[EINVAL and 
SIGSYS signal] 

[EINVAL] 



[EBADF] 
[ESPIPE] 



Fildes is not an open file descriptor. 
Fildes is associated with a pipe or fifo. 
Whence is not 0, 1 or 2. 



The resulting file pointer would be negative. 
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Returns 

Upon successful completion, a non-negative integer 
indicating the file pointer value is returned. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. 

Caution 

Not all block devices support Iseek. 

See Also 

creat, dap, fcntl, open. 
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Name 

mknod - makes a directory, or a special or ordinary file 

Format 

int mknod {path, mode, dev) 

char 'path; 

i n t mode , dev; 

Description 

The mknod system call creates a new file named by the path 
name pointed to by path. The mode of the new file is 
initialized from mode. The value of mode is interpreted as 
follows: 

0170000 file type; one of the following: 

001 0000 f i f o spec i a I 

0020000 character special 

0040000 d i rectory 

0060000 block special 

0100000 or 000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 

0000777 access permissions; constructed from the follow 
0000400 read by owner 
0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

The owner ID is set to the process' effective user ID. The 
group ID is set to the process' effective group ID. 

Values of mode other than those presented are undefined 
and should not be used. The low-order 9 bits of mode are 
modified by the process' file mode creation mask: all bits 
set in the process file mode creation mask are cleared. See 
umask. If mode indicates a block or character special file, dev 
is a configuration-dependent specification of a character or 
block I/O device. If mode does not indicate a block special 
or character special device, dev is ignored. 
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The mknod system call may be invoked only by the super-user 
for file types other than FIFO special. 

The mknod command fails and the new file is not created if 
one or more of the following are true: 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

mkdir in Section 1 ; chmod, exec, umask; fs in Section 4. 



[EPERM] 
[ENOTDIR] 
[ENOENT] 
[EROFS] 



The process's effective user ID is not super-user. 

A component of the path prefix is not a directory. 

A component of the path prefix does not exist. 

The directory in which the file is to be created is located on 
a read-only file system. 

The named file exists. 

Path points outside the allocated address space of the process. 



[EEXIST] 
[EFAULT] 
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Name 

mount - mount a file system 

Format 

int mount {spec, dir, rwflg) 
char * spec , 'dir; 
i n t rwf lg; 



Description 

The mount system call requests that a file system contained 
on the block special file identified by spec be mounted on the 
directory identified by dir. Spec and dir are pointers to path 
names. 

Upon successful completion, references to the file dir will 
refer to the root directory on the mounted file system. 

The low-order bit of rwflag is used to control write 
permission on the mounted file system; if 1 , writing is 
forbidden, otherwise writing is permitted according to 
individual file accessibility. 

mount may be invoked only by the super-user. Note that the 
system call mount (as well as umount) does not update the 
mount table file /etc/mnttab. This means that the system 
calls can not be used interchangeably with the mount and 
umount shell commands. 

mount will fail if one or more of the following are true: 



[EPERM] The effective user ID is not super-user. 

[ENOENT] Any of the named files do not exist. 

[ENOTDIR] A component of a path prefix is not a directory. 

[ENOTBLK] Spec is not a block special device. 

[ENXIO] The device associated with spec does not exist. 

[ENOTDIR] Dir is not a directory. 



1192192 



2-98 



System Calls 



mount 



[EFAULT] 



Spec or dir points outside the allocated address space of 
trie process. 



[EBUSY] 



Dir is currently mounted on, is someone's current working 
directory, or is otherwise busy. 



[EBUSY] 
[EBUSY] 
[EROFS] 



The low-order bit of rwflag is zero and the volume 
containing the file system is physically write-protected. 



There are no more mount table entries. 



The device associated with spec is currently mounted. 



Returns 

The mount command returns an integer. Upon successful 
completion, a value of 0 is returned and references to the file 
dir refer to the root directory on the mounted file system. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 



umount. 
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Name 

msgctl - message control operations 



Format 

#include <sys/ t ypes . h> 
# i nc I ude <sys/ i pc . h> 
#include <sys/msg.h> 

int msgctl (msqid, cmd , buf) 
i n t msq i d , cmd ; 
struct msqid_ds *buf; 

Description 

The msgctl system call provides a variety of message control 
operations as specified by cmd. The following cmds are 
available: 

IPC_STAT Place the current value of each member of the data structure 
associated with msqid into the structure pointed to by buf. The 
contents of this structure are defined in intro. {READ} 

IPC-SET Set the value of the following members of the data 

structure associated with msqid to the 
corresponding value found in the structure pointed 
to by but 

msg.pe rm. u i d 
msg_pe rm. g i d 

msg_perm.mod9 /' only low 9 bits */ 
msg.qby t es 

This cmd can only be executed by a process that has an effective 
user ID equal to either that of super user or to the value of 
msg_perm.uid in the data structure associated with msqid. Only 
super user can raise the value of msg_qbytes. 
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IPC_RMID Remove the message queue identifier specified by msqid from the 
system and destroy the message queue and data structure 
associated with it. This cmd can only be executed by a process 
that has an effective user ID equal to either that of super user or 
to the value of msg_perm.uid in the data structure associated with 
msqid. 

msgctl will fail if one or more of the following are true: 

[EINVAL] Msqid is not a valid message queue identifier. 

[EINVAL] Cmd is not a valid command. 

[EACCES] Cmd is equal to IPC_STAT and {READ} operation 

permission is denied to the calling process (see intro. 

[EPERM] Cmd is equal to IPC_RMID or IPC_SET. The effective user ID of 

the calling process is not equal to that of super user and it is not 
equal to the value of msg.41erm.uid in the data structure 
associated with msqid. 

[EPERM] Cmd is equal to IPC_SET, an attempt is being made to increase 

to the value of msg-qbytes, and the effective user ID of the 
calling process is not equal to that of super user. 

[EFAULT] Buf points to an illegal address. 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 



intra, msgget, msgop. 
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Name 

msgget - get message queue 

Format 

#lnclude <s y s / t y pe s . h> 
#1 nc I ude <sys/ i pc . h> 
#include <sys/msg.h> 

int msgget (key. msgflg) 
kay_t key: 
int msg f I g ; 



Description 

The msgget system call returns the message queue identifier 
associated with key. 

A message queue identifier and associated message queue 
and data structure (see intro) are created for key if one of the 
following are true: 

10 Key is equal to IPC_PHIVATE. 

Key does not already have a message queue identifier associated with it, 
and (msgflg & IPC-CREAT) is "true". 

Upon creation, the data structure associated with the new 
message queue identifier is initialized as follows: 

Msg-perm.cuid, msg-perm.uid, msg-perm.cgid, and 
msg.perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 

The low-order 9 bits of msg-pemn.mode are set equal to 
the low-order 9 bits of msgflg. 
Msg-qnum, msgJspid, msgJrpid, msgstime, and 
msgstime are set to 0. 

Msg-ctim is set to the current time. 
Msg-qbytes is set equal to the system limit. 
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msgget will fail if one or more of the following are true: 



[EACCES] 

[ENOENT] 
[ENOSPC] 

[EEXIST] 



A message queue identifier exists for key, but operation 
permission (see intra) as specified by the low-order 9 bits 
of msgflg would not be granted. 

A message queue identifier does not exist for key and 
[msgflg & IPCCREAT) is "false." 

A message queue identifier is to be created but the 
system-imposed limit on the maximum number of allowed 
message queue identifiers system wide would be exceeded. 

A message queue identifier exists for key but [(msgflg & 
IPC_CREAT) & {msgflg & IPC_EXCL}) is "true." 



Returns 

Upon successful completion, a non-negative integer, namely 
a message queue identifier, is returned. Otherwise, a value of 
-1 is returned and errno is set to indicate the error. 



See Also 



intra, msgctl, msgop. 
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Name 

msgop - message operations 

Format 

#include <sys / t ypes . h> 
# i nc I ude <sys / I pc . h> 
^include <sys/msg . h> 

int msgsnd (msqid. msgp, msgsz. msgllg) 
i n t msq i d : 

struct msgbuf 'msgp; 
i n t msgsz , msg f I g ; 

Int msgrcv (msqid, msgp, msgsz, msgtyp. msgflg) 
Int msq I d ; 

struct msgbuf 'msgp; 
Int msgsz; 
I ong msg t yp ; 
Int msg f I g : 



Description 

The msgsnd call is used to send a message to the queue 
associated with the message queue identifier specified by 
msqid. {WRITE} Msgp points to a structure containing the 
message. This structure is composed of the following 
members: 

long mtype; /" message type '/ 

char mtext[]; /* massage text •/ 

Mtype is a positive integer that can be used by the receiving 
process for message selection (see msgrcv below). Mtext is 
any text of length msgsz bytes. Msgsz can range from 0 to a 
system-imposed maximum. 
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Msgflg specifies the action to be taken if one or more of the 
following are true: 

The number of bytes already on the queue is equal to 
msg-qbytes (see intra). 

The total number of messages on all queues 
system-wide is equal to the system-imposed limit. 

These actions are as follows: 

If (msgflg & IPC_NOWAIT) is "true," the message will not 
be sent and the calling process will return immediately. 

If (msgflg & IPC_NOWAIT) is "false," the calling process will 
suspend execution until one of the following occurs: 

The condition responsible for the suspension no 
longer exists, in which case the message is sent. 

Msqid is removed from the system (see msgctl). 
When this occurs, errno is set equal to EIDRM, and a 
value of -1 is returned. 

The calling process receives a signal that is to be 
caught. In this case the message is not sent and the 
calling process resumes execution in the manner 
prescribed in signal. 

msgsnd will fail and no message will be sent if one or more of 
the following are true: 



[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process (see intra). 

[EINVAL] Mtype is less than 1. 

[EAGAIN] The message cannot be sent for one of the reasons cited 

above and (msgflg & IPCNOWAIT) is "true." 

[EINVAL] Msgsz is less than zero or greater than the system-imposed 

limit. 

[EFAULT] Msgp points to an illegal address. 
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Upon successful completion, the following actions are taken 
with respect to the data structure associated with msqid (see 
intra). 

Msg-qnum is incremented by 1 . 

MsgJspid is set equal to the process ID of the calling 
process. 

Msgstime is set equal to the current time. 

The msgrcv call reads a message from the queue associated 
with the message queue identifier specified by msqid and 
places it in the structure pointed to by msgp. {READ} This 
structure is composed of the following members: 

long mtype; /* message type '/ 

char mtext[]; /* message text •/ 

Mtype is the received message's type as specified by the 
sending process. Mtext is the text of the message. Msgsz 
specifies the size in bytes of mtext. The received message is 
truncated to msgsz bytes if it is larger than msgsz and (msgf/g 
8t MSG-NOERROR) is "true." The truncated part of the message 
is lost and no indication of the truncation is given to the 
calling process. 

Msgtyp specifies the type of message requested as follows: 

If msgtyp is equal to 0, the first message on the queue is 
received. 

If msgtyp is greater than 0, the first message of type 
msgtyp is received. 

If msgtyp is less than 0, the first message of the lowest 
type that is less than or equal to the absolute value of 
msgtyp is received. 

Msgflg specifies the action to be taken if a message of the 
desired type is not on the queue. These are as follows: 

If {msgflg & IPC_N0WAIT) is "true," the calling process will 
return immediately with a return value of -1 and errno set 
to ENOMSG. 
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If (msgflg & IPCJYOWAIT) is "false," the calling process will 
suspend execution until one of the following occurs: 

A message of the desired type is placed on the queue. 

Msqid is removed from the system. When this 
occurs, errno is set equal to EIDRM, and a value of -1 
is returned. 

The calling process receives a signal that is to be 
caught. In this case a message is not received and 
the calling process resumes execution in the manner 
prescribed in signal. 

msgrcv will fail and no message will be received if one or 
more of the following are true: 



[EINVAL] Msqid is not a valid message queue identifier. 

[EACCES] Operation permission is denied to the calling process. 

[EINVAL] Msgsz is less than 0. 

t E2BIG l Mtext is greater than msgsz and (msgflg & 

MSG-NOERROR) is "false." 

[ENOMSG] The queue does not contain a mesage of the desired type 

and [msgtyp & IPC_N0WAIT) is "true." 

[EFAULT] Msgp points to an illegal address. 



Upon successful completion, the following actions are taken 
with respect to the data structure associated with msqid (see 
intra). v 

Msg-qnum is decremented by 1 . 
MsgJrpid is set to the current time. 
Msgstime is set to the current time. 
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Returns 

If msgsnd or msgrcv return due to the receipt of a signal, a 
value of -1 is returned to the calling process and errno is set 
to EINTR. If they return due to removal of msqid from the 
system, a value of -1 is returned and errno is set to EIDRM. 

Upon successful completion, the return value is as follows: 

msgsnd returns a value of 0. 

msgrcv returns a value equal to the number of bytes 
actually placed into mtext. 

Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

intro, msgctl, msgget, signal. 
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Name 

nice - change priority of a process 

Format 

i n t nice ( / ncr) 
i n t incr; 



Description 

The nice system call adds the value of incr to the nice value 
of the calling process. A process' nice value is a positive 
number. A higher nice value results in a lower CPU priority. 

The system allows nice values only from -8 to 39. The nice 
system call grants nice values from -8 to -1 only to 
super-user processes. These negative nice values cause the 
CPU priority of the process to be fixed independently of CPU 
usage of the process, nice values from 0 to 39 allow the 
system to adjust dynamically the actual CPU priority of the 
process, temporarily lowering it in proportion to the process' 
recent level of CPU usage. If a super-user process requests a 
nice value below -8, or if any other process requests a nice 
value below 0, the system imposes a nice value of 0. If any 
process requests a nice value above 39, the system imposes 
a nice value of 39. 

l EPERM l The nice call fails and does not change the nice value if 

incr is negative and the effective user ID of the calling 
process is not super-user. 

Returns 

Upon successful completion, nice returns the new nice value 
minus 20. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. To receive the current nice value, use 0 

as incr. 



See Also 

nice in Section 1 , exec. 
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Name 

open - open a file for reading or writing 

Format 

# i nc I ude < 1 cn t I . h> 

int open (path, otlag\. mode]) 

char 'path: 

int otlag, mode : 



Description 

Path points to a path name naming a file. The open system 
call opens a file descriptor for the named file and sets the file 
status flags according to the value of of lag. Of lag values are 
constructed by or-ing flags from the following list (only one 
of the first three flags may be used): 



0_RD0NLY 
(LWRONLY 
0_RDWR 
0-NDELAY 



Open for reading only. 
Open for writing only. 
Open for reading and writing. 

This flag may affect subsequent reads and writes. See read 
and write. 

When opening a FIFO with 0_RD0NLY or 0-WR0NLY set: 



If 0-NDELAY is set: 

An open for reading-only will return without delay. 
An open for writing-only will return an error if no 
process currently has the file open for reading. 

If 0_NDELAY is clear: 

An open for reading-only will block until a process 
opens the file for writing. An open for writing-only 
will block until a process opens the file for reading. 
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When opening a file associated with a communication line: 
If (LNDELAY is set: 

The open will return without waiting for a carrier. 
If (LNDELAY is clear: 

The open will block until carrier is present. If you 
want to configure an RS-232 modem entry, you must 
declare the async line in the CP or TP configuration 
file (for example, CPOO.cnf) as a modem. To do this 
enter: 

Async 1, speed -9600, modem 

When an OpenTerminal request is received, the code 
in the TP or CP raises data terminal ready (DTR) and 
asserts request to send (RTS). It then wafts for data 
set ready (DSR) to be asserted. BTOS will wait up to 
3 seconds for DSR. If DSR is not received in that 
time, the request is rejected with an ere 11010 
(ercDSRNotDetected). Assuming that DSR is 
recognized, the processor will then begin to wait for 
data carrier detBrt (DCD). There is no timeout 
waiting for DCD. The OpenTerminal will return only 
when DCD has been asserted. 

After a successful OpenTerminal, ReadTerminal 
requests will return the ercCarrierLoss error if the 
carrier has dropped since the last request. The 
fCarrierDetect flag in the terminal output structure 
will follow the current value of the DCD RS-232 signal. 

CloseTerminal drops RTS and DTR and pauses 0 25 
second to allow DSR time to drop on mechanically 
switched modems. 



0J\PPEND |f set, the file pointer is set to the end of the file prior to 

each write. 

(LNODIRECT Do not perform direct I/O for this file, even if a transfer 

satisfies the system default criteria. 
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O SYnc If set, all writes will be synchronous. This option applies 

only to regular files. 

O-CREAT » the file exists, this flag has no effect. Otherwise, the file 

owner ID is set to the process's effective user ID, the file 
group ID is set to the process's effective group ID, and the 
low-order 10 bits of the file mode are set to the value of 
mode, modified as follows (see creat): 

All bits set in the process file mode creation mask 
are cleared. See umask. 

The "save text image after execution" bit of the mode 
is cleared. See chmod. 

The process's default cluster size exponent determines the 
cluster size of files created on PILF file systems. 

If the file exists, its length is truncated to 0 and the mode 
and owner are unchanged. 

If O-EXCL and O-CREAT are set and the file exists, open 
fails. O-EXCL has no meaning unless it is used with O-CREAT. 

The file pointer used to mark the current position within the 
file is set to the beginning of the file. 
The new file descriptor is set to remain open across exec 
system calls. See fcntl. 

The named file is opened unless one or more of the following 
are true: 



0.TRUNC 
O-EXCL 



[ENOTDIR] 

[ENOENT] 

[EACCES] 

[EACCES] 

[EISDIR] 

[EROFS] 



A component of the path prefix is not a directory. 

O-CREAT is not set and the named file does not exist. 

A component of the path prefix denies search permission. 

Oflag permission is denied for the named file. 

The named file is a directory and oflag is write or read/write. 

The named file resides on a read-only file system and oflag 
is write or read/write. 
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[EMFILE] 
[ENXIO] 



The named file is a character special or block special file, 
and the device associated with this special file does not exist. 



Twenty file descriptors are currently open. 



[ETXTBSY] 



The file is a pure procedure (shared text) file that is being 
executed and oflag is write or read/write. 



[EFAULT] 
[EEXIST] 
[ENXIO] 



(LNDELAY is set, the named file is a FIFO, (LWRONLY is 
set, and no process has the file open for reading. 
A signal was caught during the open system call. 



0_CREAT and CLEXCL are set, and the named file exists 



Part points outside the allocated address space of the process. 



[EINTR] 
[ENFILE] 



The system file table is full. 



Returns 

Upon successful completion, the file descriptor is returned 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

chmod, close, creat, dup, fcntl, locking, Iseek, pipe, read, umask 
write; pilf in Section 5. 
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Name 

pause - suspend process until signal 

Format 

pause ( ) 

Description 

The pausB system call suspends the calling process until it 
receives a signal. The signal must be one that is not currently 
set to be ignored by the calling process. 
If the signal causes termination of the calling process, pause 
will not return. 

If the signal is caught by the calling process and control is 
returned from the signal-catching function (see signal), the 
calling process resumes execution from the point of 
suspension; with a return value of -1 from pause and errno set 
to EINTR. 

See Also 

alarm, kill, signal, wait. 
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Name 

pipe - create an interprocess channel 

Format 

i n t pipe {til ties) 
int II ldes[2\ ; 



Description 

The pipe system call creates an I/O mechanism called a pipe 
and returns two file descriptors, fildes[Q\ and fildes[1} 
Fildes[0] is opened for reading and fi/des[ 1 ] is opened for writing. 

Up to 5120 bytes of data are buffered by the pipe before the 
writing process is blocked. A read on file descriptor fildes[0\ 
accesses the data written to fildes{\\ on a first-in-first-out 
(FIFO) basis. 

The call will fail if one or both are true: 

[EMFILE] 19 or more file descriptors are currently open. 

[ENFILE] The system file table is full. 



Returns 

Upon successful completion, a value of 0 is returned 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 



sh in Section 1 ; read, write. 
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Name 

plock - lock process, text, or data in memory 

Format 

# i nc I ude <sys / I ock . h> 

i n 1 plock ( op) 
i n t op: 

Description 

The plock system call allows the calling process to lock its 
text segment (text lock), its data and stack segments (data 
lock) or both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine 
swapping, plock also allows these segments to be unlocked. 
For 407 object modules, TXTLOCK and DATLOCK are 
identical The effective user ID of the calling process must be 
super-user to use this call. Op specifies the following: 

PROCLOCK Lock text and data segments into memory (process lock). 
TXTLOCK Lock text segment into memory (text lock). 

DATLOCK Lock data segment into memory (data lock). 

UNLOCK Remove locks. 

Shared regions (that is, text) may be locked by anyone using 
the text, but they may be unlocked only if the caller is the 
last one using the region. Note that sticky-bit text that is not 
explicitly unlocked will remain locked in core even after the 
last process using it terminates. 
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The plock 

operation 

[EPERM] 
[EINVAL] 

[EIIWALJ 

[EINVAL] 

[EINVAL] 

Returns 

Upon successful completion, a value of 0 is returned to the 
calling process. Otherwise, a value of -1 is returned and errno 
is set to indicate the error. 

See Also 



call fails and does not perform the requested 
if one or more of the following are true: 

The effective user ID of the calling process is not super-user. 

Op is equal to PROCLOCK and a process lock, a text lock or a 
data lock already exists on the calling process. 

Op is equal to TXTLOCK and a text lock, or a process lock already 
exists on the calling process. 

Op is equal to DATLOCK and a data lock, or a process lock 
already exists on the calling process. 

Op is equal to UNLOCK and no type at lock exists on the calling process. 



exec, exit, fork. 
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Name 

profil - execution time profile 

Format 

void profil (buff, bufslz, offset, scale) 
char * bu f f ; 

i n t bu f s i z , offset, scale; 

Description 

Buff points to an area of core whose length (in bytes) is 
given by bufsiz. After this call, the user's program counter 
(pc) is examined each clock tic, (60th second); offset \s 
subtracted from it. and the result is multiplied by scale. If the 
resulting number corresponds to a word inside buff, that 
word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction 
with binary point at the left; 0177777 (octal) gives a 1-1 
mapping of pc's to words in buff; 077777 (octal) maps each 
pair of instruction words together. 02(octal) maps all 
instructions onto the beginning of buff (producing a 
non-interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1 It is 
rendered ineffective by giving a bufsiz of 0. Profiling is turned 
off when an exec is executed, but remains on in child and 
parent both after a fork. Profiling will be turned off if an 
update in buff would cause a memory fault. 

Returns 

Not defined. 

See Also 

prof in Section 1; monitor in Section 3. 
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Name 

ptrace - process trace 

Format 

Int ptrace (request, pid, addr, data); 
Int request, pid, addr, data; 

Description 

The ptrace system call provides a means by which a parent 
process may control the execution of a child process. Its 
primary use is for the implementation of breakpoint 
debugging; see sdb in Section 1 . The child process behaves 
normally until it encounters a signal (see signal for the list), at 
which time it enters a stopped state and its parent is notified 
by wait. When the child is in the stopped state, its parent can 
examine and modify its "core image" using ptrace. Also, the 
parent can cause the child either to terminate or continue, 
with the possibility of ignoring the signal that caused it to stop. 

The request argument determines the precise action to be 
taken by ptrace and is one of the following: 

0 This request must be issued by the child process if it is to be 

traced by its parent. It turns on the child's trace flag that 
stipulates that the child should be left in a stopped state upon 
receipt of a signal rather than the state specified by tunc, see 
signal. The pic, addr, and data arguments are ignored, and a 
return value is not defined for this request. Peculiar results will 
ensue if the parent does not expect to trace the child. 

The remainder of the requests can only be used by the 
parent process. For each, pid is the process ID of the child. 
The child must be in a stopped state before these requests 
are made. 



System Calls 



2-119 



ptrace 

1, 2 With these requests, the word at location addr in the address 
space of the child is returned to the parent process. If I and D 
space are separated (as on PDP-lls), request 1 returns a word 
from I space, and request 2 returns a word from D space. If I and 
D space are not separated (as on Burroughs 68000-family 
processors, the 3B 20S computer, and VAX-1 1/780), either 
request 1 or request 2 may be used with equal results. The data 
argument is ignored. These two requests will fail if addr is not the 
start address of a word, in which case a value of -1 is returned to 
the parent process and the parent's errno is set to EIO. 

3 With this request, the word at location addr in the child's USER 

area in the system's address space (see <sys/user.h>) is 
returned to the parent process. Addresses in this area range from 
0 to 8192 on Burroughs 68000-family processors, 0 to 1024 on 
the PDP-lls and 0 to 2048 on the 3B 20 computer and VAX. 
The data argument is ignored. This request will fail if addr is not 
the start address of a word or is outside the USER area, in which 
case a value of -1 is returned to the parent process and the 
parent's errno is set to EIO. 

4, 5 With these requests, the value given by the data argument is 
written into the address space of the child at location addr. If I 
and D space are separated (as on PDP-11s), request 4 writes a 
word into I space, and request 5 writes a word in to D space. If I 
and 0 space are not separated (as on Burroughs 68000-family 
processors, the 3B 20 computer, and VAX), either request 4 or 
request 5 may be used with equal results. Upon successful 
completion, the value written into the address space of the child is 
returned to the parent. These two requests will fail if addr is a 
location in a pure procedure space and another process is 
executing in that space, or addr is not the start address of a 
word. Upon failure a value of -1 is returned to the parent process 
and the parent's errno is set to EIO. 

6 With this request, a few entries in the child's USER area can be 

written. Data gives the value that is to be written and addr is the 
location of the entry. The few entries that can be written are: 
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The general registers (that is, registers 0-15 on Burroughs 
68000-family processors, registers 0-1 1 on the 3B 20S 
computer, registers 0-7 on POP- lis, and registers 0-15 on 
the VAX). 

The condition codes of the Processor Status Word on the 
3B 20 computer. 

The floating point status register and six floating point 
registers on PDP-1 1s. 

certain bits of the Processor Status Word on PDP-1 Is (that 
is, bits 0-4, and 8-11). 

Certain bits of the Processor Status Longword on the VAX 
(that is, bits 0-7, 16-20, and 30-31). 

Burroughs 68000-family processors: all processor status bits 
except 8, 9, 10, and 13. 

7 This request causes the child to resume execution. If the data 
argument is 0, all pending signals, including the one that caused 
the child to stop, are canceled before it resumes execution. If the 
data argument is a valid signal number, the child resumes 
execution as if it had incurred that signal, and any other pending 
signals are canceled. The addr argument must be equal to 1 for 
this request. Upon successful completion, the value of data is 
returned to the parent. This request will fail if data is not 0 or a 
valid signal number, in which case a value of -1 is returned to the 
parent process and the parent's errno is set to EIO. 

8 This request causes the child to terminate with the same 
consequences as exit. 

9 This request sets the trace bit in the Processor Status Word of 
the child (i.e., bit 15 on Burroughs 68000-family processors, bit 4 
on PDP-1 Is; bit 30 on the VAX) and then executes the same 
steps as listed above for request 7. The trace bit causes an 
interrupt upon completion of one machine instruction. This 
effectively allows single stepping of the child. On the 3B 20S 
computer there is no trace bit and this request returns an error. 
Note that the trace bit remains set after an interrupt on PDP-1 Is 
but is turned off after an interrupt on the VAX. 
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To forstall possible fraud, ptrace inhibits the set-user-id facility 
on subsequent exec calls. If a traced process calls exec, it will 
stop before executing the first instruction of the new image 
showing signal SIGTRAP. 

ptrace will in fail if one or more of the following are true: 



[BO] 
[ESRCH] 



Request is an illegal number. 

Pid identifies a child that does not exist or has not executed 
a ptrace with request 0. 



See Also 

exec, signal, wait. 
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Name 

read - read from a file 



Format 

int read (tildes, but, nbyte) 
i n 1 tildes; 
char 'but; 
unsigned nbyte : 



Description 

Fildes is a file descriptor obtained from a creat, open, dup fcntl 
or pipe system call. 

read attempts to read nbyte bytes from the file associated 
with fildes into the buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in 
the fi e pointer associated with fildes. Upon return from read 
the file pointer is incremented by the number of bvtes 
actually read. 

Devices that are incapable of seeking always read from the 
current position. The value of a file pointer associated with 
such a file is undefined. 

Upon successful completion, read returns the number of bytes 
actually read (a non-negative integer) and placed in the 
buffer; this number may be less than nbyte if the file is 
associated with a communication line (see ioctl; see termio in 
Section 6), or if the number of bytes left in the file is less 
than nbyte bytes. A value of 0 is returned when an end-of-file 
has been reached. 

When attempting to read from an empty pipe (or FIFO): 
d If 0_NDELAY is set, the read returns a 0. 

□ If 0 NDELAY is clear, the read blocks until data is written 
to the file or the file is no longer open for writing. 
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When attempting to read a file associated with a tty that has 
no data currently available: 

□ If O-NDELAY is set, the read returns a 0. 

□ If 0_NDELAY is clear, the read blocks until data becomes 
available. 

The read call fails if one or more of the following are true: 

[EBADF] Fildes is not a valid file descriptor open for reading. 

[EFAULT] But points outside the allocated address space. 

[EDEADLOCK] A side effect of a previous locking call. 

Returns 

Upon successful completion, a non-negative integer is 
returned indicating the number of bytes actually read. If read 
terminates unsuccessfully, a value of -1 is returned and ermo 
is set to indicate the error. 

Caution 

Large data reads that are 4K (4096 bytes), or exact multiples 
of 4K, will pad the remaining portion of the read buffer with 
zeros when the data transferred does not completely fill the 
buffer. A data read that is not a multiple of 4K, however, will 
not pad the read buffer with zeros. 

See Also 

create, dup, fcntl, ioctl, locking, open, pipe; termio in Section 6. 
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Name 

sbrk - change data segment space allocation 



Format 

char *sbrk ( i ncr) 

i n t /ncr; 



Description 

See brk. 
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Name 

semctl - semaphore control operations 

Format 

#include <s y s / t ype s . h> 
# i nc I ude <sy s/ i pc . h> 
#include <sy s / sem . h> 

int semctl (semid. semnum, cmd , arg) 
i n t sem i d , cmd ; 
int semnum; 
union semun ( 

int va I ; 

struct semld_ds "but; 
ushort 'array: 

} arg: 



Description 

The semctl system call provides a variety of semaphore 
control operations as specified by cmd. 

The following cmds are executed with respect to the 
semaphore specified by semid and semnum: 



GETVAL 
SETVAL 



GETPID 

GETNCNT 

GETZCNT 



Return the value of semval (see intro). {READ} 

Set the value of semval to arg.val. (ALTER) When this 
cmd is successfully executed, the semadj value 
corresponding to the specified semaphore in all processes is 
cleared. 

Return the value of sempid. {READ! 
Return the value of semncnt. {READ} 
Return the value of semzcnt. {READ} 
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The following cmds return and set, respectively, every semval 
in the set of semaphores. 

GETALL face semvals into array pointed to by arg.array. {READ) 

SETALL Set semvals according to the array pointed to by arg.array. 

{ALTER} When this and is successfully executed, the 
semadj values corresponding to each specified semaphore in 
all processes are cleared. 

The following cmds are also available: 

IPCSTAT place the current value of each member of the data 

structure associated with semid into the structure pointed to 
by arg.buf. The contents of this structure are defined in 
intra. (READ) 

IPC_SET Set the value of the following members of the data 

structure asociated with semid to the corresponding value 
found in the structure pointed to by arg.but. 

sem_pe rm. u I d 
sem_perm. g | d 

sem_pe rm.mode /• only low 9 bits •/ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to the 
value of sem_perm.uid in the data structure associated with 
semid. 

IPC_HMID Remove the semaphore identifier specified by semid from the 

system and destroy the set of semaphores and data structure 
associated with it. This emrfcan only be executed by a 
process that has an effective user ID equal to either that of 
super-user or to the value of sem_perm.uid in the data 
structure associated with semid. 

semctl will fail if one or more of the following are true: 

[EINVAL] Semid is not a valid semaphore identifier. 

[EINVAL] Semnum is less than zero or greater than serruisems. 

l EINVAL J Cmd is not a valid command. 
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[EACCES] 
[ERANGE] 

[EPERM] 



[EFAULT] 



Operation permission is denied to the calling process (see intro). 

Cmd is SETVAL or SETALL and the value to which semval 
is to be set is greater than the system imposed maximum. 

Cmd is equal to IPC-RMIO or IPC_SET and the effective 
user ID of the calling process is not equal to that of 
super-user and it is not equal to the value of sem-perm.uid 
in the data structure associated with semid. 

Arg.buf points to an illegal address. 



Returns 

Upon successful completion, the value returned depends on 
cmd as follows. 



GETVAL 
GETPID 
GETNCNT 
GETZCNT 

All others 



The value of semval. 
The value of sempid. 
The value of semncnt. 
The value of semzcnt. 
A value of 0. 



Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

intro, semget, semop. 



1192192 



2-128 



System Calls 



semget 

Name 

semget - get set of semaphores 

Format 

#include <s y s / I y pa s . h> 
#include <sys/ipc.h> 
^include <sys/sam.h> 

int semget (key, nsems, semflg) 

key_t key ; 

i nt nsems , semf I g ; 

Description 

The semget system call returns the semaphore identifier 
associated with key. 

A semaphore identifier and associated data structure and set 
containing nsems semaphores (see intra) are created for key if 
one of the following are true: 

Key is equal to IPC_PRIVATE. 

Key does not already have a semaphore identifier 
associated with it, and Semflg & IPCCREAT) is "true." 

Upon creation, the data structure associated with the new 
semaphore identifier is initialized as follows: 

Sem-perm.cuid, sem^perm.uid, sem^perm.cgid, and 
sem-perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 

The low-order 9 bits of sem^perm.mode are set equal to 
the low-order 9 bits of semflg. 

Semuisems is set equal to the value of nsems. 

Sem_otime is set equal to 0 and semuctime is set equal 
to the current time. 
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semget will fail if one or more of the following are true: 



[EINVAL] 
[EACCES] 

[EINVAL] 

[ENOENT] 
[ENOSPC] 

[ENOSPC] 

[EEXIST] 



Nsems is either less than or equal to zero or greater than 
the system-imposed limit. 

A semaphore identifier exists for key, but operation 
permission (see intro) as specified by the low-order 9 bits 
of semflg would not be granted. 

A semaphore identifier exists for key, but the number of 
semaphores in the set associated with it is less than nsems 
and nsems is not equal to zero. 

A semaphore identifier does not exist for key and {semflg & 
IPC_CREAT) is "false." 

A semaphore identifier is to be created but the 
system-imposed limit on the maximum number of allowed 
semaphore identifiers system wide would be exceeded. 

A semaphore identifier is to be created but the 
system-imposed limit on the maximum number of allowed 
semaphores system wide would be exceeded. 

A semaphore identifier exists for key but [(semflg & 
IPCCREAT) and (semflg & IPC_EXCL)) is "true." 



Returns 

Upon successful completion, a non-negative integer, namely 
a semaphore identifier, is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 



See Also 

intro, semctl, semop. 
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Name 

semop - semaphore operations 

Format 

#lnclude <sys / 1 ypes . h> 
#includo <sys/ipc.h> 
#include <sys/sem.h> 

Int semop (semid, sops, nsops) 
int semi d ; 

struct sembuf **sops; 
I n t nsops ; 



Description 

The semop system call is used to automically perform an array 
of semaphore operations on the set of semaphores 
associated with the semaphore identifier specified by semid 
Sops is a pointer to the array of semaphore-operation 
structures. Nsops is the number of such structures in the 
array. The contents of each structure include the following 
members: 

short sem_num /• semaphore number '/ 

short sem_op /• semaphore operation •/ 

short sem_flg /• operation flags •/ 

Each semaphore operation specified by semuop is performed 
on the corresponding semaphore specified by semid and 
semjium. 
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Sem-op specifies one of three semaphore operations as follows: 

If sem-op is a negative integer, one of the following will 
occur: {ALTER) 

If semval (see intra) is greater than or equal to the 
absolute value of sem-op, the absolute value of 
sem-op is subtracted from semval. Also, if (semJIg 
& SENLUNDO) is "true," the absolute value of semuop 
is added to the calling process's semadj value (see 
exit) for the specified semaphore. All processes 
suspended waiting for semval are rescheduled. 

If semval is less than the absolute value of sem-op 
and (semJIg & IPC-NOWAIT) is "true," semop will 
return immediately. 

If semval is less than the absolute value of sem-op 
and {semJIg & IPC-NOWAIT) is "false," semop will 
increment the semncnt associated with the specified 
semaphore and suspend execution of the calling 
process until one of the following conditions occur: 

Semval becomes greater than or equal to the 
absolute value of sem-op. When this occurs, 
the value of semncnt associated with the 
specified semaphore is decremented, the 
absolute value of sem-op is subtracted from 
semval and, if (semJIg & SENLUNDO) is "true," 
the absolute value of sem-op is added to the 
calling process's semadj value for the specified 
semaphore, and all the operations are tried again. 

The semid for which the calling process is 
awaiting action is removed from the system 
(see semctl). When this occurs, errno is set equal 
to EIDRM, and a value of -1 is returned. 
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The calling process receives a signal that is to 
be caught. When this occurs, the value of 
semncnt associated with the specified 
semaphore is decremented, and the calling 
process resumes execution in the manner 
prescribed in signal. 

If sem^op is a positive integer, the value of sem_op is 
added to semval and, if (semJIg & SENLUNDO) is "true," 
the value of sem^op is subtracted from the calling 
process's semadj value for the specified semaphore. 
{ALTER} 

If sem_op is zero, one of the following will occur: {READ} 

If semval is zero, semop will return immediately. 

If semval is not equal to zero and (semJIg & 
IPC-NOWAIT) is "true," semop will return immediately. 

If semval is not equal to zero and (semJIg & 
IPC_NOWAIT) is "false," semop will increment the 
semzcnt associated with the specified semaphore 
and suspend execution of the calling process until 
one of the following occurs: 

Semval becomes zero, at which time the value 
of semzcnt associated with the specified 
semaphore is decremented. 

The semid for which the calling process is 
awaiting action is removed from the system. 
When this occurs, errno is set equal to EIDRM, 
and a value of -1 is returned. 

The calling process receives a signal that is to 
be caught. When this occurs, the value of 
semzcnt associated with the specified 
semaphore is decremented, and the calling 
process resumes execution in the manner 
prescribed in signal. 
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semop will fail if one or more of the following are true for any 
of the seamphore operations specified by sops: 

[EINVAL] Semid is not a valid semaphore identifier. 

[EFBIG] Sem-num is less than zero or greater than or equal to the number 

of semaphores in the set associated with semid. 

[E2BIG] Nsops is greater than the system-imposed maximum. 

[EACCES] Operation permission is denied to the calling process (see intro). 

[EAGAIN] The operation would result in suspension of the calling process but 

{sem-flg & IPC_NOWAIT) is "true." 

[ENOSPC] The limit on the number of individual processes requesting a 

SEM.UNDO would be exceeded. 

[EINVAL] The number of individual semaphores for which the calling process 

requests a SEM-UNDO would exceed the limit. 

[ERANGE] An operation would cause a semval to overflow the 

system-imposed limit. 

[ERANGE] An operation would cause a semadj value to overflow the 

system-imposed limit. 

[EFAULT] Sops points to an illegal address. 

Upon successful completion, the value of sempid for each 
semaphore specified in the array pointed to by sops is set 
equal to the process ID of the calling process. 

Returns 

If semop returns due to the receipt of a signal, a value of -1 is 
returned to the calling process and errno is set to EINTR. If it 
returns due to the removal of a semid from the system, a 
value of -1 is returned and errno is set to EiDRM. 

Upon successful completion, the value of zero is returned. 
Otherwise, a value of -1 is returned and errno is set to indi- 
cate the error. 
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See Also 

exec, exit, fork, intra, semctl, semget. 
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Name 

setgid - set group ID 

Format 

I n l setgid ( g I d ) 
i n t g i d ; 

Description 

setgid is used to set the real group ID and effective group ID 
of the calling process. 

If the effective user ID of the calling process is super-user, 
the real group ID and effective group ID are set to gid. 

If the effective user ID of the calling process is not 
super-user, but its real group ID is equal to gid, the effective 
group ID is set to gid. 

If the effective user ID of the calling process is not 
super-user, but the saved set-group ID from exec is equal to 
gid, the effective group ID is set to gid. 

setgid will fail if the real group ID of the calling process is not 
equal to gid and its effective user ID is not super-user. [EPERM] 

Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

getuid, intro, setuid. 
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Name 

setpgrp - set process group ID 

Format 

Int setpgrp ( ) 

Description 

Setpgrp sets the process group ID of the calling process to 
the process ID of the calling process and returns the new 
process group ID. 

Returns 

Setpgrp returns the value of the new process group ID. 

See Also 

exec, fork, getpid, intra, kill, signal. 
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Name 

setuid - set user ID 



Format 

i n t setuid (uid) 
i n t uid; 

Description 

setuid is used to set the real user ID and effective user ID of 
the calling process. 

If the effective user ID of the calling process is super-user, 
the real user ID and effective user ID are set to uid. 

If the effective user ID of the calling process is not 
super-user, but its real user ID is equal to uid, the effective 
user ID is set to uid. 

If the effective user ID of the calling process is not 
super-user, but the saved set-user ID from exec is equal to 
uid, the effective user ID is set to uid. 

setuid will fail if the real user ID of the calling process is not 
equal to uid and its effective user ID is not super-user 
[EPERM], or if the uid is out of range [EINVAL]. 

Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

getuid, intro. 
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Name 

shmctl - shared memory control operations 

Format 

#!nclude <sys/ types . h> 
#lnclude <sys/ipc.h> 
#include <sys/shm.h> 

int shmctl (shmld, cmd , bur) 
i n t shmi d , cmd ; 
struct shmi d_d s * b u I ; 

Description 

The shmctl system call provides a variety of shared memory 
control operations as specified by cmd. The followinq cmds 
are available: 

Place the current value of each member of the data 
structure associated with shmid into the structure pointed to 
by buf. The contents of this structure are defined in intra 
{READ} 

Set the value of the following members of the data 
structure associated with shmid to the corresponding value 
found in the structure pointed to by buf. 

shm_pe rm. u I d 
shm_pe rm. g j d 

shm_perm.mode /• only low 9 bits ■/ 

This cmd can only be executed by a process that has an 
effective user ID equal to either that of super-user or to the 
value of shnLperm.uid in the data structure associated with 

shmid. 



IPCSTAT 



IPC_SET 
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IPC-RMIO Remove the shared memory identifier specified by shmid 

from the system and destroy the shared memory segment 
and data structure associated with it. This and can only be 
executed by a process that has an effective user ID equal to 
either that of super-user or to the value of shm-perm.uid in 

the data structure associated with shmid. 

shmctl will fail if one or more of the following are true: 



[EINVAL] 
[EINVAL] 
[EACCES] 

[EPERM] 



[EFAULT] 



shmid is not a valid shared memory identifier. 

Cmd is not a valid command. 

Cmd is equal to IPC_STAT and {READ} operation 
permission is denied to the calling process (see intra). 

Cmd is equal to IPC_RMID or IPC_SET and the effective 
user ID of the calling process is not equal to that of 
super-user and it is not equal to the value of shm-perm.uid 
in the data structure associated with shmid. 

Buf points to an illegal address. 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

intra, shmget, shmop. 
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Name 

shmget - get shared memory segment 

Format 

#lnclude <sys/ t ypes . h> 
# i nc I ude <sy s / i pc . h> 
#inolude <sys/shm.h> 

Int shmget (key, size, shmflg) 

key_t key; 

Int size, shmf I g ; 



Description 

The shmget system call returns the shared memory identifier 
associated with key. 

A shared memory identifier and associated data structure 
and shared memory segment of size size bytes (see intra) are 
created for key if one of the following are true: 

Key is equal to IPC_PRIVATE. 

Key does not already have a shared memory identifier 
associated with it, and (shmflg & IPCCREAT) is "true." 

Upon creation, the data structure associated with the new 
shared memory identifier is initialized as follows: 

Shm-perm.cuid, shm^erm.uid, shm.perm.cgid and 
shm-perm.gid are set equal to the effective user ID and 
effective group ID, respectively, of the calling process. 

The low-order 9 bits of shm^perm.mode are set equal to 
the low-order 9 bits of shmflg. Shmsegsz is set equal to 
the value of size. 

ShmJpid, shm_nattch, shm^atime, and shm_dtime are set 
to 0. 



Shm-ctime is set equal to the current time. 
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shmget will fail 



[EINVAL] 
[EACCES] 

[EINVAL] 

[ENOENT] 
[ENOSPC] 

[ENOMEM] 

[EEXIST] 



if one or more of the following are true: 

Size is less than the system-imposed minimum or greater than the 
system-imposed maximum. 



A shared memory identifier exists for key but operation permission 
(see intro) as specified by the low-order 9 bits of shmflg would 
not be granted. 

A shared memory identifier exists for key but the size of the 
segment associated with it is less than size and size is not equal 
to zero. 

A shared memory identifier does not exist for key and {shmflg & 
IPC_CREAT) is "false." 

A shared memory identifier is to be created but the 
system-imposed limit on the maximum number of allowed shared 
memory identifiers system wide would be exceeded. 

A shared memory identifier and associated shared memory segment 
are to be created but the amount of available physical memory is 
not sufficient to fill the request. 

A shared memory identifier exists for key but {[shmflg & 
IPC-CREAT) and {shmflg & IPC.EXCl)) is "true." 



Returns 

Upon successful completion, a non-negative integer, namely 
a shared memory identifier, is returned. Otherwise, a value of 
-1 is returned and errno is set to indicate the error. 



See Also 

intra, shmctl, shmop. 
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Name 

shmop - shared memory operations 

Format 

#include <sy s / t ypes . h> 
^include <sys/ipc.h> 
#inciude <sys/shm.h> 

char *shmat (shmid, shmaddr, shmflg) 
int shmld; 
char 'shmaddr 
Int shmflg; 

int shmdt (shmaddr) 
char "shmaddr 



Description 

shmat attaches the shared memory segment associated with 
the shared memory identifier specified by shmid to the data 
segment of the calling process. The segment is attached at 
the address specified by one of the following criteria: 

If shmaddr is equal to zero, the segment is attached at 
the first available address as selected by the system. 

If shmaddr is not equal to zero and (shmflg & SHIVLRND) is 
"true," the segment is attached at the address given by 
(shmaddr - (shmaddr modulus SHMLBA)). 

If shmaddr is not equal to zero and (shmflg & SHIVLRND) i« 
false, the segment is attached at the address qiven bv 
shmaddr. 1 

The segment is attached for reading if (shmflg & 
SHIVLRDONLY) is "true" {READ}, otherwise it is attached for 
reading and writing {READ/WRITE}. 
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The available data space is not large enough to 
accommodate the shared memory segment. 

Shmaddr is not equal to zero, and the value of [shmaddr - 
(shmaddr modulus SHMLBA)) is an illegal address. 

Shmaddr is not equal to zero, {shmflg & SHM_RND) is 
"false," and the value of shmaddr is an illegal address. With 
the initial resease, this value is 64K. This value can be 
changed by customizing the CENTIX kernel. 

The number of shared memory segments attached to the 
calling process would exceed the system-imposed limit. 

shmdt detaches from the calling process's data segment 
the shared memory segment located at the address specified 
by shmaddr. 

shmdt will fail and not detach the shared memory segment 
if shmaddr is not the data segment start address of a 
shared memory segment. 

Returns 

Upon successful completion, the return value is as follows: 

shmat returns the data segment start address of the 
attached shared memory segment. 

shmdt returns a value of 0. 
Otherwise, -1 is returned and errno is set to indicate the error. 

Caution 

Processes that share a segment of memory on an 
Application Processor must be executing on that AP. 
Memory cannot be shared across Application Processors. 

See Also 

exec, exit, fork, intra, shmctl, shmget. 



shmop 

[ENOMEM] 
[EINVAL] 
[EINVAL] 

[EMFILE] 
[EINVAL] 

[EINVAL] 
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Name 

signal - specify what to do upon receipt of a signal 

Format 

# I no I ude <s I gna I . h> 

i n t ( *3 i gna I (sign, f unc ) ) ( ) 

I n t s i g ; 

void ( * ( unc ) ( ) ; 

Description 

The signal system call allows the calling process to choose 
one of three ways in which it is possible to handle the 
receipt of a specific signal. S/g specifies the signal and func 
specifies the choice. 

Sig can be assigned any one of the following except SIGKILL: 



SIGHUP 01 Hangup. 

SIGINT 02 Interrupt. 

SIGQUIT 03 Quit, 

S ,GILL 04 Illegal instruction (not reset when caught). 

SIGTRAP 05 Trace trap (not reset when caught). 

SIGI °T 06 I0T instruction. 

SIGEMT 07 EMT instruction. 

SIGFPE 08 Floating point exception. 

s,GKiLL 09 Kill (cannot be caught or ignored). 

SIGBUS 10 Bus error. 

SIGSEGV 1 1 Segmentation violation. 

SIGSYS 12 Bad argument to system call. 

SIGPIPE 1 3 Write on a pipe with no one to read it. 

SIGALRM 14 Alarm clock. 

SIGTERM 15 Software termination signal. 

SIGUSR1 16 User-defined signal 1. 

SIGUSR2 17 User-defined signal 2. 

S| GCLD 18 Death of a child (reset when caught). 

SIGPWR 19 Power fail (not reset when caught). 



See below for the significance of the asterisk (*) in the above list. 
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Func is assigned one of three values: SIGJJFL, SIGJGN, or a 
function address. The actions prescribed by these values are 
as follows: 

SIG.DFL Terminate process upon receipt of a signal. 

Upon receipt of the signal sig, the receiving process is to be 
terminated with all of the consequences outlined in exit. In 
addition a "core image" will be made in the current working 
directory of the receiving process if sig is one for which an 
asterisk appears in the above list and the following 
conditions are met: 

The effective user ID and the read user ID of the 
receiving process are equal. 

An ordinary file named core exists and is writable or 
can be created. If the file must be created, it will 
have the following properties: 

A mode of 0666 modified by the file creation 
mask (see umask\2)) 

A file owner ID that is the same as the 
effective user ID of the receiving process. 

A file group ID that is the same as the 
effective group ID of the receiving process. 

SIGJGN Ignore signal. 

The signal sig is to be ignored. Note that the signal 
SIGKILL cannot be ignored. 

function address Catch signal. 

Upon receipt of the signal sig, the receiving process is to 
execute the signal-catching function pointed to by func. The 
signal number sig will be passed as the only argument to 
the signal-catching function. Before entering the 
signal-catching function, the value of func for the caught 
signal will be set to SIGJJFL unless the signal is SIGILL. 
SIGTRAP, or SIGPWR. 
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Upon return from the signal-catching function, the receiving 
process will resume execution at the point it was 
interrupted. 

When a signal that is to be caught occurs during a read, a 
write, an open, or an ioctl system call on a slow device 
(like a terminal; but not a file), during a pause system call, 
or during a wait system call that does not return 
immediately due to the existence of a previously stopped or 
zombie process, the signal catching function will be 
executed and then the interrupted system call may return a 
-1 to the calling process with errno set to EINTR Note 
that the signal SIGKILL cannot be caught. 

A call to signal cancels a pending signal sig except for a 
pending SIGKILL signal. 

signal will fail if sig is an illegal signal number, includinq 
SIGKILL. [EINVAL] a 



Returns 

Upon successful completion, signal returns the previous value 
of tunc for the specified signal sig. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 



Caution 

Two other signals that behave differently than the signals 
described above exist in this release of the system. They are: 

S,GCLD 18 Death of a child (reset when caught). 

SIGPWR 19 Power fail (not reset when caught). 

There is no guarantee that, in future release of the CENTIX 
system, these signals will continue to behave as described 
below; they are included only for compatibility with some 
versions of the UNIX system. Their use in new proqrams is 
strongly discouraged. 
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For these signals, tunc is assigned one of three values: 
SIG-DFL, SIGJGN, or a function address. The actions prescribed 
by these values are as follows: 

SIG-DFL Ignore signal. 

The signal is to be ignored. 

SIGJGN Ignore signal. 

The signal is to be ignored. Also, if sig is SIGCLD, the 
calling process's child processes will not create zombie 
processes when they terminate; see exit. 

function address Catch signal. 

If the signal is SIGPWR, the action to be taken is the 
same as that described above for tunc equal to function 
address. The same is true if the signal is SIGCLD except 
that while the process is executing the signal-catching 
function, any received SIGCLD signals will be queued and 
the signal-catching function will be continually reentered 
until the queue is empty. 

The SIGCLD affects two other system calls (wait, and exit) in 
the following ways: 

wait If the tunc value of SIGCLD is set to SIGJGN and a wait is 

executed, the wait will block until all of the calling process s child 
processes terminate; it will then return a value of -1 with ermo 
set to ECHILD. 

exit If in the exiting process's parent process the tunc value of 

SIGCLD is set to SIGJGN, the exiting process will not create a 
zombie process. 
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Known Problems 

A user process cannot catch a signal caused by an invalid 
memory reference during a partially completed instruction 
Thus SIGSEGV can be ignored or be allowed to terminate the 
process, but cannot be caught. This bug is due to a 
temporary implementation problem. 

See Also 

kill in Section 1 ; kill, pause, ptrace, wait, setjmp in Section 3. 
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Name 

stat, fstat - get file status 

Format 

# Include <s y s / t ype s . h> 
# include <sys/stat.h> 

Int stat {path, buf) 
char 'path; 
struct stat 'but; 

int fstat { f I Ides, but) 
Int / / Ides; 
struct stat ' but ; 



Description 

Path points to a path name naming a file. Read, write, or 
execute permission of the named file is not required, but all 
directories listed in the path name leading to the file must be 
searchable, stat obtains information about the named file, stat 
works with all files, but does not obtain information peculiar 
to PILF files (see syslocal; see pilf in Section 5). 

Similarly, fstat obtains information about an open file known 
by the file descriptor tildes, obtained from a successful open, 
creat, dup, fcntl, or pipe system call. 

Buf is a pointer to a stat structure into which information 
about the file is placed. 

The contents of the structure pointed to by buf include the 
following members: 

ushort st_mode; /'File mode; see mknod - / 

ino_t st_lno; /*l-node number - / 

dev_t st_dev; /*ID of device containing - / 

/ - a directory entry for this file"/ 
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dev_t 


8 t _r da v ; 


shor t 


8 t _n 1 1 n k ; 


u s ho r t 


>t_uld; 


ushor t 


»t_gld; 


Of f_t 


» t_s 1 ze ; 


t lme_t 


s t_a t Ime ; 


t ime_t 


s t_mt ima ; 


t lme_t 


at_ct Ima : 



st-atime 

st-mtime 

sLctime 



I ' ID of dev ice*/ 

/'This entry Is defined only for'/ 
/'character special or block'/ 
/'special f I les'/ 
/'Number of I inks'/ 
/'User ID of the file's owner'/ 
/'Group ID of the file's group*/ 
/'File size In bytes*/ 
/•Time of last access*/ 
/'Time of last data modification*/ 
/'Time of last file status change*/ 
/"Times measured in seconds since*/ 
/"00:00:00 GMT , Jan. 1, 1970'/ 

Time when file data was last accessed. Changed by the 
following system calls: creat, mknod, pipe, and read. 

Time when data was last modified. Changed by the following 
system calls: creat, mknod, pipe, and write. 

Time when file status was first changed. Changed by the 
following system calls: chmod, chown, creat, link, mknod, 
pipe, unlink, and write. 



Note that when recreating a file that already exists and the 
existing file is more than zero bytes in length, only the 
modification time {.stsntime) and the file status time 
(st-ctime) are updated. The file data access time is not 
updated since this field in the buffer changes only when 
data from the file is actually accessed. If you recreate an 
existing file that is zero bytes in length, the modification 
time, file status time, and file data access time will not be 
updated. 

The stat call fails if one or more of the following are true: 

[ENOTDIR] A component of the path prefix is not a directory. 

(ENOENT] The named file does not exist. 

[EACCES] Search permission is denied for a component of the path prefix. 

[EFAULT] Buf or path points to an invalid address. 
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The fstat call fails if one or more of the following are true: 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

chmod, chown, creat, link, mknod, pipe, read, syslocal, time, 
unlink, utime, write. 



[EBADR] 
[EFAULT] 



Fildes is not a valid open file descriptor. 
Buf points to an invalid address. 



1192192 



2-152 



System Calls 



stime 

Name 

stime - set time 

Format 

i n t s t tme ( tp) 
I ong • t p ; 

Description 

The stime system call sets the system's idea of the time and 
date. Tp points to the value of time as measured in seconds 
from 00:00:00 GMT, January 1 , 1 970. 

stime fails if: 

[EPERM] The effective user ID of the calling process is not super-user. 

Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 

time. 
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Name 

swrite - synchronous write on a file 

Format 

Int swrite (tildes, but, nbyte) 
i n t f i Ides; 
char ' but ; 
unsigned nbyte; 



Description 

The swrite system call has the same purpose and conventions 
as write. The two differ solely in the handling of disk 
input/output, swrite, unlike write, does not give a normal 
return before physical output is complete. A program that 
executes an swrite can assume that the data is on the disk, 
not waiting in a buffer pool. 



See Also 

creat, dup, Iseek, open, pipe, write. 



1192192 



2-154 



System Calls 



sync 

Name 

sync - update super-block 

Format 

vo i d sync ( ) 

Description 

The sync system call causes all information in memory that 
should be on disk to be written out. This includes modified 
super blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, 
for example fsck and df. It is mandatory for a boot. 

The writing, although scheduled, is not necessarily complete 
upon return from sync. 
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Name 

syslocal - special system requests 

Format 

#include <sys I oca I . h> 

int syslocal ( cmd{ , arg] ...) 
I n t cmd ; 

Description 

The syslocal system call executes certain special system calls. 
The specific call is indicated by the first argument. 

System Type 

int syslocal ( SYSL_SYSTEM) ; 

Return SYSL_XE for the XE 500. 
Superblock Synchronization 

Int syslocal ( SYSL_RESYNC . devnum) 
short devnum 

Preserve current contents of the superblock. Devnum 
specifies the file system: the high order byte contains the 
major device number of the character special device; the low 
order byte contains the minor device number. The superblock 
is reread, replacing the current in-RAM copy of the 
superblock. Both actions have the effect of preventing the 
system from writing out the superblock, undoing, for 
example, the effects of file system repair. 

Application Processor Number 

syslocal (SYSL_APNUM) 

Return the processor number of the Application Processor on 
which this process is executing. 
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Total Application Processors 

sys loca I ( SYSL_TOTAPS ) 

Return the total number of Application Processors currently 
running. 



Console Control 

sys loca I (SYSL_CONSOLE . t ype , action) 
i n t t ype . action; 

Manage Application Processor console. Affects AP on which 
this process is running. Type specifies the type of action, 
action the specific action. Values of type are: 0 to query 
console status, 1 to associate the terminal with a terminal, 2 
to control kernel prints, and 3 to control entry to the kernel 
debugger. 

If type is 0 and action is 1, the return value indicates the 
terminal association of the console: a positive value is the 
terminal number of the associated terminal; -1 indicates that 
no terminal is associated with the console. 

If type is 0 and action is 2, the return value gives the status 
of kernel diagnostic prints: 0 for off, 1 for on. 

If type is 0 and action is 3, the return value tells whether 
entry to the kernel debugger is enabled: 0 for no, 1 for yes. 

If type is 0 and action is 4, the contents of the console's 
circular buffer are written to standard output. 

If type is 1 , action indicates a new terminal association for 
the console. If action is 0, terminal association is removed. If 
action is -1, the console is associated with the UART kludge 
port. If action is positive, it must be the file descriptor for an 
open terminal special file; the console is associated with that 
terminal. If the terminal is under window management, then 
the file descriptor refers to one of the windows in that 
terminal; the console is associated with that particular 
window. A return value of 0 indicates a successful 
association, a -1 indicates an unsuccessful association, with 
the error value set in errno. 
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If type is 2, action controls diagnostic prints: 0 disables, any 
other value enables. 

If type is 3, action controls access to the kernel debugger: 0 
disables, 1 enables, and any other value must be a process 
group whose terminal/window is to have kernel prints 
enabled. When access to the kernel debugger is enabled, 
entering a CTRL-B or CODE-B on the console terminal enters 
the kernel debugger. 

Maximum Number of Users 

syslocal ( SYSL_MAXUSERS) 

Returns maximum number of concurrent logins on the 
processor on which this process is executing. 

PILF File Status 

Note that the following calls must be compiled with the -D 
PILF option. 

#include <prof.h> 
# I nc I ude <s t a t . h> 
#include <types.h> 

syslocal (SYSL_PSTAT, name, st_buf) 
char ' name 

struct p_s tat ' s t_bu I ; 

syslocal ( SYSL_PFSTAT , fd, st_but) 
i n t f d ; 

struct p_stat *st_buf; 

struct p_s t a t 
( 

dev_t st_dev; 

ino_t st_lno; 

u s h o r t st _mo d e ; 

short st _n link; 

ushort st_uid; 

u short st_gld; 

dev_t st_rdev; 
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of l_t 
t i me_t 
t i me_t 
t i me_t 
char 



s t_s i ze ; 
s t_a t i me ; 
s t_mt ime ; 
s l_c t i me ; 



s t _c luster ; 



These calls work exactly like stat and fstat (see stat), except 
that the status structure has one additional field, st^cluster, 
which gives the cluster size exponent of the file. 

Get Process's Cluster Size Exponent 

syslocal ( SYSL_GETCLUS ) 

sysloca I (SYSL_SETCLUS, cluster) 
int cluster; 

A process's cluster size exponent sets the cluster size 
exponent of any files the process creates on PILF file 
systems. A process's cluster size exponent can be -1 , 
indicating that the new file's cluster size exponent should be 
taken from the file system's default cluster size exponent. A 
new process inherits its parent's exponent. 

syslocal SYSL_GETCLUS returns a positive value if a previous 
SYSL_SETCLUS was issued; otherwise, -1 is returned. 

syslocal SYSL_SETCLUS sets the process's cluster size 
exponent to cluster. 



Caution 

Kernel prints and the kernel debugger syslocal calls that 
support them may disappear without notice. Use of kernel 
prints degrades system performance. Use of the kernel 
debugger halts normal processing. 

See Also 

apnum, fsck in Section 1 ; openi; pilf in Section 5; console in 

Section 6. 
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Name 



time - 



get time. 



Format 



ong 



t i me ( ( long * ) 0 ) 



I ong 
I ong 



t Ime | Moc) 
• t loc: 



Description 

The time system call returns the value of time in seconds 
since 00:00:00 GMT, January 1, 1970. 

If tloc (taken as an integer) is non-zero, the return value is 
also stored in the location to which tloc points. 

[EFAULT] time will fail if tloc points to an illegal address. 

Returns 

Upon successful completion, time returns the value of time. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 



stime. 
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Name 

times - get process and child process times 

Format 

#lnclude <s y s / t y pes . h> 
#1 nc I ude <sys/ t imes . h> 

I ong t Imes (but far) 
struct tms 'butter; 

Description 

The times system call fills the structure indicated by buffer 
with time-accounting information. The structure takes the 
following form: 

struct tms ( 

t ime_t tms_ut ime ; 
t lme_t tms_s t Ime ; 
t ime_t tms_cu t ime ; 
t lme_t tms_cs t Ime ; 

} ; 

The time accounting information comes from the calling 
process and each of its terminated child processes for which 
it has executed a wait. Times are in 60ths of a second. 

Tms utime is the CPU time used while executing instructions 
in the user space of the calling process. 
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Tmsstime is the CPU time used by the system on behalf of 
the calling process. 

Tms-cutime is the sum of the tms-utimes and tms-cutimes of 
the child processes. 

Tms-cstime is the sum of the tms^stimes and tms-cstimes of 
the child processes. 

The times call will fail if 

[EFAULT] Buffer points to an illegal address. 

Returns 

Upon successful completion, times returns the elapsed real 
time, in 60ths of a second, since an arbitrary point in the 
past (such as system start-up time). This point does not 
change from one invocation of times to another. If times fails, 
a -1 is returned and errno is set to indicate the error. 

See Also 

exec, fork, time, wait. 
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Name 

ulimit - get and set user limits 

Format 

long ulimit (cmd, newl imi t ) 

I n t cmd ; 

I ong newl imi t ; 

Description 

This system call provides for control over process limits. The 
cmd values available are: 

1 Get the file size limit of the process. The limit is in units of 
512-byte blocks and is inherited by child processes. Files of any 
size can be read. 

2 Set the file size limit of the process to the value of newlimit. Any 
process may decrease this limit, but only a process with an 
effective user ID of super-user may increase the limit, ulimit will 
fail and the limit will be unchanged if a process with an effective 
user ID other than super-user attempts to increase its file size 
limit. [EPERMJ 

3 Get the maximum possible break value. See brk. 

Returns 

Upon successful completion, a non-negative value is 
returned. Otherwise, -1 is returned and errno is set to indicate 
the error. 



See Also 

brk, write. 
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Name 

umask - set and get the file creation mask 

Format 

i n t umask ( cmask ) 
i n t cmask ; 

Description 

The umask system call sets the process file mode creation 
mask to cmask. Only the low-order 9 bits of cmask and the 
file mode creation mask are used. 

Returns 

The previous value of the file mode creation mask is returned. 

See Also 

mkdir, sh in Section 1 , chmod, creat, mknod, open. 
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Name 

umount - unmount a file system 

Format 

i n t umoun t ( spec) 
char * spec ; 

Description 

The umount system call requests that a previously mounted 
file system contained on the block special device identified 
by spec be unmounted. Spec is a pointer to a path name. 
After unmounting the file system, the directory upon which 
the file system was mounted reverts to its ordinary 
interpretation. 

umount may be invoked only by the super-user, 
umount fails if one or more of the following are true: 



f EPERM 3 The process's effective user ID is not super-user. 

[ENXIO] Spec does not exist. 

[ENOTBLK] Spec is not a block special device. 

[EINVAL] Spec is not mounted. 

[EBUSY] A file on spec is busy. 

[EFAULT] Spec points to an illegal address. 



Returns 

Upon successful completion, a value of 0 is returned 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

mount. 
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Name 

uname - get name of current CENTIX system 



Format 

#include <sy s / u t sname . h> 

int uname (name) 
struct ut sname 'name; 

Description 

uname stores information identifying the current CENTIX 
system in the structure pointed to by name. 
uname uses the structure defined in <sys/utsname.h> whose 
members are: 

char sysname[9]; 

char nodename[9]; 

char release[9]; 

char version[9]; 

char machine[9]; 

uname returns a null-terminated character string naming the 
current CENTIX system in the character array sysname. 
Similarly, nodename contains the name that the system is 
known by on a communications network. Release and version 
further identify the operating system. Machine contains a 
standard name that identifies the hardware that the CENTIX 
system is running on. 

[EFAULT] uname will fail if name points to an invalid address. 
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Returns 

Upon successful completion, a non-negative value is 
returned. Otherwise, -1 is returned and errno is set to indicate 
the error. 



See Also 



uname in Section 1 . 
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Name 

unlink - remove directory entry 

Format 

i n t unlink (path) 
char 'path; 



Description 

The unlink system call removes the directory entry named by 
the path name pointed to by path. 
The named file is unlinked unless one or more of the 
following are true: 



A component of the path prefix is not a directory. 

The named file does not exist. 

Search permission is denied for a component of the path prefix. 

Write permission is denied on the directory containing the 
link to be removed. 

The named file is a directory and the effective user ID of 
the process is not super-user. 

The entry to be unlinked is the mount point for a mounted 
file system. 

The entry to be unlinked is the last link to a pure procedure 
(shared text) file that is being executed. 

The directory entry to be unlinked is part of a read-only file 
system. 

Path points outside the allocated address space of the process. 

When all links to a file have been removed and no process 
has the file open, the space occupied by the file is freed and 
the file ceases to exist. If one or more processes have the 
file open when the last link is removed, the removal is 
postponed until all references to the file have been closed. 



[ENOTDIR] 
[ENOENT] 
[EACCES] 
[EACCES] 

[EPERM] 

[EBUSY] 

[ETXTBSY] 

[EROFS] 

[EFAULTJ 
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Returns 

Upon successful completion, a value of 0 is returned 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 



See Also 



rm in Section 1 ; close, link, open. 
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Name 

ustat - get file system statistics 



Format 

#includs <sys/ types . h> 
# i nc I ude <us t a t . h> 



i n t ustat ( dev , but) 
i n t dev; 

struct ustat 'but; 



Description 

The ustat system call returns information about a mounted file 
system Dev is a device number that identifies the device 
containing a mounted file system. Buf is a pointer to a ustat 
structure that includes the following elements: 



dadd r. 



f _t f roe ; /'Total free blocks'/ 

nolt f_tlnode; /'Number of free i-nodes'/ 

char f_fname[6]; / ' F i I sy s name ' / 

char f_fpack[6]; /'Fllsy* pack name*/ 

ustat fails if one or both of the following are true: 

[EINVAL] Dev is not the device number of a device containing a 

mounted file system. 

[EFAULT] Appoints outside the allocated address space of the process. 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and ermo is set to 
indicate the error. 



See Also 

stat; fs in Section 4. 
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Name 

utime - set file access and modification times 

Format 

#include <sy s / t y pes . h> 

# i nc I ude <use r . h> 

# I nc I ude <u f s . h> 

I n t u t ime (path, t imes ) 
char "path; 
struct t imes • tm; 



Description 

Path points to a path name naming a file. The utime system 
call sets the access and modification times of the named file. 
If times is NULL, the access and modification times of the file 
are set to the current time. A process must be the owner of 
the file or have write permission to use utime in this manner. 
If times -is not NULL, times is interpreted as a pointer to a 

cffl i StrU °, tUre and the access and modification times are 
set to the values contained in the designated structure. Only 
the owner of the file or the super-user may use utime this way. 

The times in the following structure are measured in seconds 
since 00:00:00 GMT, Jan. 1, 1970. 



struct t I mes { 

t lme_t acc_t ime ; 
t ime_t mocf_t ime ; 



access t ime • / 
mod i f I cat i on t ime 



) 
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utime will fail if one or more of the following are true: 



[ENOENT] 


The named file does not exit. 


[ENOTDIR] 


A component of the path prefix is not a directory. 


[EACCES] 


Search permission is denied by a component of the path prefix. 


[EPERM] 


The effective user ID is not super-user and not the owner of the 


♦Ha and tirrtac io nnt Ml It 1 
Tile 3nu Utnco 15 HUl IVULL. 


[EACCES] 


The effective user ID is not super-user and not the owner of the 


file and times is NULL and write access is denied. 


[EROFS] 


The file system containing the file is mounted read-only. 


[EFAULT] 


Times is not NULL and points outside the process's allocated 


address space. 


[EFAULT] 


Path points outside the process's allocated address space. 


Returns 





Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

See Also 

stat. 



1192192 



2-172 



Sysiem Calls 



wait 

Name 

wait - wait for a child process to stop or terminate 

Format 

int wa i t ( s fa t_i oc) 
ini ' stat_loc; 

Int wal t ( ( int * )0) 

Description 

The wait system call suspends the calling process until one of 
the immediate children terminates or until a child that is being 
traced stops because it has hit a break point. The call will 
return prematurely if a signal is received; if a child process 
stopped or terminated prior to the call on wait, return is 
immediate. 

If stat Joe (taken as an integer) is non-zero, 16 bits of 
information called status are stored in the low order 1 6 bits 
of the location pointed to by statJoc. Status can be used to 
differentiate between stopped and terminated child 
processes. If the child process has terminated, status 
identifies the cause of termination and passes useful 
information to the parent. This is accomplished in the 
following manner: 

If the child process stopped, the high order 8 bits of 
status contain the number of the signal that caused the 
process to stop and the low order 8 bits are set equal to 

If the child process terminated due to an exit call, the low 
order 8 bits of status are zero and the high order 8 bits 
contain the low order 8 bits of the arguments that the 
child process passed to exit. See exit 
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If the child process terminated due to a signal, the high 
order 8 bits of status are zero and the low order 8 bits 
contain the number of the signal that caused the 
termination. In addition, if the low order seventh bit (for 
example, bit 200) is set, a core image is produced. 

If a parent process terminates without waiting for its child 
processes to terminate, the parent process ID of each child 
process is set to 1 . This means that the initialization process 
inherits the child processes. See intra, 
wait fails and returns immediately if one or both of the 
following are true: 

[ECHILD] The calling process has no existing unwaited-for child 

processes. 

[EFAULT] StaUoc points to an illegal address. 

Returns 

If wait returns due to receipt of a signal, a value of -1 is 
returned to the calling process and anno is set to EINTR. it 
wait returns due to a stopped or terminated child process, 
the process ID of the child is returned to the calling process. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

Caution 

SIGCLD (termination of a created process) affects wait. If the 
func of SIGCLD is set to SIGJGN (ignore signal) and a wait is 
executed, the wait blocks until all created processes of the 
calling process terminate. It then returns a value of -1 with 
errno set to ECHILD. 

See Also 

exec, exit, fork, intra, pause, ptrace, signal. 
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Name 



write - write on a file 



Format 



Int write (tildes, but, nbyte) 
int tildes; 
char • but ; 
unsigned nbyte; 



Description 

Fildes is a file descriptor obtained from a creat, open, dup fcntl 
or pipe system call. 

The write system call attempts to write nbyte bytes from the 
buffer pointed to by bufxo the file associated with fildes. 

On devices capable of seeking, the actual writing of data 
proceeds from the position in the file indicated by the file 
pointer. Upon return from write, the file pointer is incremented 
by the number of bytes actually written. 

On devices incapable of seeking, writing always takes place 
starting at the current position. The value of a file pointer 
associated with such a device is undefined. 

If the 0_APPEND flag of the file status flags is set, the file 
pointer is set to the end of the file prior to each write. 

write fails and the file pointer remains unchanged if one or 
more of the following are true: 



[EBADF] 

[EPIPE and 
SIGPIPE signal] 

[EFBIG] 



Fildes is not a valid file descriptor open for writing. 

An attempt is made to write to a pipe that is not open for 
reading by any process. 

An attempt was made to write a file that exceeds the 
process's file size limit or the maximum file size. See ulimit. 

Buf points outside the process's allocated address space. 

A signal was caught during the write system call. 



[EFAULT] 
[EINTR] 
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fENOSPCl Additional blocks cannot be allocated to the file because the 

file system has no free blocks or because a PILF file s 
cluster size exceeds the size of the unallocated clusters. 

[EDEADLOCK] A side effect of a previous locking call. 

If a write requests that more bytes be written than there is 
room for (that is, the ulimit or the physical end of a medium), 
only as many bytes as there is room for are written. For 
example, suppose there is space for 20 more bytes in a file 
before reaching a limit. A write of 512 bytes will return 20. 
The next write of a non-zero number of bytes results in a 
failure return (except as noted below). 
If the file being written is a pipe (or FIFO), no partial writes 
are permitted. Thus, the write fails if a write of nbyte bytes 
exceeds a limit. 

If the file being written is a pipe (or FIFO), and the 
0_NDELAY flag of the file flag word is set, then a write to a 
full pipe returns a count of 0. Otherwise (OJMDELAY clear), 
writes to a full pipe block until space becomes available. 

Returns 

Upon successful completion, the number of bytes actually 
written is returned. Otherwise, -1 is returned and errno is set 
to indicate the error. 

See Also 

creat, durv Iseek, locking, open, pipe. 
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Library Functions 
intra 

Name 

intra - introduction to libraries and subroutines 



Description 

This section describes functions found in various libraries 
(other than those functions that directly invoke CENTIX 
system primitives, which are described in Section 2). The 
functions are divided into four major categories: 

o The Standard C Library functions. These functions, along 
with those in Section 2 and those in the Standard I/O 
Package (below), constitute the Standard C Library, libc. 
The libc library is automatically loaded by the C compiler, 
cc (see Section 1). The link editor Id (Section 1) searches 
this library under the -Ic option. Declarations for some of 
these functions may be obtained from #include files 
indicated on the appropriate pages. 

D The Math Library functions. These functions constitute the 
Math Library, libm. They are not automatically loaded by 
the C compiler, cc; however, the link editor searches this 
library under the -Im option. Declarations for these 
functions may be obtained from the #include file 
<math.h>. 

□ The Standard I/O Package functions. These functions are ii 
the library libc, mentioned earlier. Declarations for these 
functions may be obtained from the #include file 

<stdio.h>. 

□ Various specialized libraries. The files in which these 
libraries are found are given on the appropriate pages. 

Two groups of entries represent direct communication with 
BTOS Functions whose names begin with of (outside file 
system) provide BTOS-style input/output. Functions whose 
names begin with qu (queue) provide access to BTOS queue 
management. 
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For convenience, many of the functions in this section are 
grouped under single headings. The following table lists all 
functions in each of the above categories, along with the 
entries under which the functions should be referenced. 

Table 3-1 Library Functions 

In the C Library: 



Punrtinn 


Hnfnrannn 


Description 


a64l 


dUHl 


Convert between long integer and base-64 
ASCII string. 


abort 


abort 


Generate an I0T fault. 


abs 


abs 


Return integer absolute value. 


asctime 


ctime 


Convert date and time to string. 


atof 


atof 


Convert ASCII string to floating-point number. 


atof 


All lUu 


Convert string to double-precision number. 


atoi 


strtol 


uonven siring 10 integer. 


atol 


strtol 


uunveiL aii my lo inieyer. 


bsearch 


hsparrh 

lineal uii 


Binary search a sorted table. 


callnr 


IlldllUC 


Main memory allocator. 


clock 


clock 


Report CPU time used. 


crypt 


crypt 


Generate DES encryption. 


ctime 


ctime 


Convert date and time to string. 


dial 


dial 


Establish an out-going terminal line connection. 


drand48 


drand48 


Generate uniformly distributed pseudo-random 
numbers. 


ecvt 


ecvt 


Convert floating-point number to string. 


edata 


end 


Last locations in programs. 


encrypt 


crypt 


Generate DES encryption. 


end 


end 


Last locations in programs. 
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Table 3-1 Library Functions (Cont.) 

Function Reference Description 

endgrent getgrent Close group file entry. 

endpwent getpwent Close password file entry. 

endutent getut Close utmp file entry. 

erand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

errno perror System error messages. 

etext end Last locations in programs. 

fcrt ecvt Convert floating-point number to string. 

f getc getc Get character from a stream. 

fgetgrent getgrent Get group file entry. 

fgetpwent getpwent Get password file entry. 

f ree malloc Main memory allocator. 

frexp frexp Manipulate parts of floating-point numbers. 

ft w ftw Walk a file tree. 

gcvt ecvt Convert floating-point number to string. 

getc getc Get character from a stream. 

getchar getc Get character from a stream. 

getcwd getcwd Get the path-name of the current working 

directory. 

getenv getenv Return value for environment name. 

getgrent getgrent Get group file entry. 

getgrgid getgrent Get group file id. 

getgrnam getgrent Get group file name. 

getlogin getlogin Get login name. 

getopt getopt Get option letter from argument vector. 

getpass getpass Read a password. 
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Table 3-1 Library Functions (Cont.) 



Function 


Reference 


Description 


getpw 


getpw 


Get name from UIO. 


getpwent 


getpwent 


Get password file entry. 


getpwnam 


getpwent 


Get password file name. 


getpwuid 


getpwent 


Get password file user id. 


getutent 


getut 


Access utmp file entry. 


getutid 


getut 


Access utmp file entry. 


getutline 


getut 


Access utmp file entry. 


getw 


getc 


Get word from a stream. 


gmtime 


ctime 


Convert date and time to string. 


gsignal 


ssignal 


Software signals. 


hcreate 


hsearch 


Create hash tables. 


hdestroy 


hsearch 


Destroy hash tables. 


hsearch 


hsearch 


Search hash tables. 


isalnum 


ctype 


Determine if a character is alphanumeric. 


isalpha 


ctype 


Determine if a character is alphabetic. 


isascii 


ctype 


Determine if an integer is an ASCII character. 


isatiy 


ttyname 


Find name of a terminal. 


iscntrl 


ctype 


Determine if a character is a rnntrnl rhwartor 


isbigit 


ctype 


Determine if a character is a decimal digit. 


isgraph 


ctype 


Determine if a character is printable. 


islower 


ctype 


Determine if a character is a lower case letter. 


isprint 


ctype 


Determine if a character is printable. 


ispunct 


ctype 


Determine if a character is a punctuation 
character. 


isspace 


ctype 


Determine if a character is a white space 
character. 
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Function Reference Description 

isupper ctype Determine if a character is an upper case letter. 

isxdigit ctype Oetermine if a character is a hexadecimal digit. 

jrand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

I3t 0 | l3tol Convert between 3-byte integers and long 

integers. 

I64a a64l Convert between long integer and base-64 

ASCII string. 

lcong48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

Idexp frexp Manipulate parts of floating-point numbers. 

Ifind Isearch Linear search and update, 

localtime ctime Convert date and time to string, 

longjmp setjmp Non-local goto. 

Irand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

Isearch Isearch Linear search and update. 

| t0 |3 l3tol Convert between 3-byte integers and long 

integers. 

malloc malloc Main memory allocator. 

memccpy memory Copy characters from one memory area to another. 

memchr memory Search for specified character in a block of 

memory. 

memcmp memory Compare blocks of memory, 

memcpy memory Copy one block of memory to another, 

memset memory Set a block of memory to a specified value, 

mktemp mktemp Make a unique file name. 
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Table 3-1 Library Functions (Cont.) 
Function Reference Description 

modf frex P Manipulate parts of floating-point numbers, 

monitor monitor Prepare execution profile. 

mrand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

nlist "list Get entries from the name list. 

nrand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

P error perror System error messages. 

putenv putenv Change or add value to environment. 

putpwent putpwent Write password file entry. 

pututline getut Write out supplied utmp structure into the 

utmp file. 

qsort qsort Quicker sort. 

rand rand Random number generator. 

rea,loc malloc Main memory allocator. 

seed48 drand48 Seed uniformly distributed pseudo-random 

number generator. 

setgrent getgrent Reset group file to allow repeated searches. 

setjmp setjmp Non-local goto. 

setkey crypt Generate DES encryption. 

setpwent getpwent Reset password file to allow repeated 

searches. 

setutent getut Reset input stream to beginning of utmp file. 

s,ee P sleep Suspend execution for interval. 

sran d rar| d Simple random number generator. 

srand48 drand48 Generate uniformly distributed pseudo-random 

numbers. 

ssignal ssignal Software signals. 
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Function 


Reference 


Description 


stdipc 


stdipc 


Standard interprocess communication package 
(ftok). 


strcat 


string 


Concatenate two strings. 


strchr 


string 


Search a string for a character. 


strcmp 


string 


Compare two strings. 


strcpy 


string 


Copy a string over another string. 


strcspn 


string 


Determine the length of an initial segment of a 
string. 


strlen 


string 


Determine the length of a string. 


strncat 


string 


Append one string to another. 


strncmp 


string 


Compare two strings. 


strncpy 


string 


Copy one string over another string. 


strpbrk 


string 


Search a string for a specified set of 
characters. 


strrchr 


string 


Search a string in reverse order for a specified 
character. 


strspn 


string 


Determine the length of an initial string. 


strtod 


strtod 


Convert string to double-precision number. 


strtok 


string 


Search a string for a token. 


strtol 


strtol 


Convert string to long integer. 


swab 


swab 


Swap bytes. 


sys_errlist 


perror 


System error messages. 


sys_nerr 


perror 


System error messages. 


tdelete 


tsearch 


Delete a node from a binary search tree. 


tfind 


tsearch 


Search for data in a binary search tree. 


toascii 


conv 


Translate characters to ASCII. 


tolower 


conv 


Convert a character to lower case. 


_tolower 


conv 


Convert an upper case letter to lower case. 
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Function 


Reference 


Description 


toupper 


conv 


Convert a character to upper case. 


—toupper 


conv 


Convert a lower case letter to upper case. 


tsearch 


tsearch 


Build and access binary search tree. 


twalk 


tsearch 


Walk a binary search tree. 


ttyname 


ttyname 


Find name of a terminal. 


ttyslot 


ttyslot 


Find the slot in the utmp file of the current user. 


tzset 


ctime 


Convert date and time to string. 


undial 


dial 


Release an out-going terminal line connection. 


utmpname 


getut 


Change utmp file name. 



In the Math Library: 




acos 


trig 


Arccosine function. 


asin 


trig 


Arcsine function. 


atan 


trig 


Arctangent function. 


atan2 


trig 


Arctangent function. 


ceil 


floor 


Ceiling function. 


cos 


trig 


Cosine function. 


cosh 


sinh 


Hyperbolic cosine function. 


erf 


erf 


Error function. 


erfc 


erf 


Complementary error function. 


exp 


exp 


Exponential function. 


fabs 


floor 


Absolute value function. 


floor 


floor 


Floor function. 


fmod 


floor 


Remainder function. 


gamma 


gamma 


Log gamma function. 


hypot 


hypot 


Euclidean distance function. 
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Table 3-1 Library Functions (Cont.) 



Function 


Reference 


Description 


io 


Bessel 


Bessel function. 


P 


Bessel 


Bessel function. 


i" 


Bessel 


Bessel function. 


log 


exp 


Logarithm function. 


loglO 


exp 


Logarithm base ten function. 


matherr 


matherr 


Error handling function. 


pow 


exp 


Power function. 


sin 


trig 


Sine function. 


sinh 


sinh 


Hyperbolic sine function. 


sqrt 


exp 


Square root function. 


tan 


trig 


Tangent function. 


tanh 


sinh 


Hyperbolic tangent function. 


yo 


Bessel 


Bessel function. 


yi 


Bessel 


Bessel function. 


yn 


Bessel 


Bessel function. 



In the Standard I/O 


Package: 


clearerr 


ferror 


Stream status inquiry. 


ctermid 


ctermid 


Generate file name for terminal. 


cuserid 


cuserid 


Get character login name of the user. 


fclose 


fclose 


Close a stream. 


fdopen 


fopen 


Open a stream. 


feof 


ferror 


Stream status inquiry. 


ferror 


ferror 


Stream status inquiry. 


fflush 


fclose 


Flush a stream. 


fgetc 


getc 


Get a character from a stream. 


fgets 


gets 


Get a string from a stream. 
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Function 


Reference 


Description 


fifeno 


terror 


Stream status inquiry. 


fopen 


topen 


Open a stream. 


fprintf 


printt 


Print formatted output. 


fputc 


putc 


Put a character on a stream. 


fputs 


puts 


put a string on a stream. 


fscanf 


scant 


Convert formatted input. 


fseek 


fseek 


Reposition a file pointer in a stream. 


fread 


fread 


Read from binary input. 


freopen 


fopen 


Open a stream. 


fteli 


fseek 


Reposition a file pointer in a stream. 


fwrite 


fread 


Write to binary output. 


getc 


getc 


Get character from a stream. 


getchar 


getc 


Get character from a stream. 


gets 


gets 


Get a string from a stream. 


getw 


getc 


Get a word from a stream. 


pclose 


popen 


Close a stream opened by popen. 


popen 


popen 


Initiate pipe to/from a process. 


printf 


printf 


Print formatted output. 


putc 


putc 


Put character on a stream. 


putchar 


putc 


Put character on a stream. 


puts 


puts 


Put a string on a stream. 


putw 


putc 


Put a word on a stream. 


rewind 


fseek 


Reposition a file pointer in a stream. 


scant 


scant 


Convert formatted input. 


setbuf 


setbuf 


Assign buffering to a stream. 


setubuf 


setbuf 


Assign buffering to a stream. 


sprintf 


printf 


Print formatted output. 
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Library Functions (Cont.) 


Function 


Reference 


ccranf 


scant 


stdio 


stdio 


system 


system 


1GI 11UI Ivl M 


tmpnam 


tmpfile 


tmpfile 


tmpnam 


tmpnam 


iiiuidIi* 

ungeic 


i innate 


vfprintf 


vprintf 


vprintf 


vprintf 


vsprintf 


vprintf 


In Various Specialized Libraries 


assert 


assert 


calloc 


malloc (fast version) 


curses 


curses 


free 


malloc (fast version) 


Idaclose 


Idclose 


Idahread 


Idahread 


Idaopen 


Idopen 


Idclose 


Idclose 


Idfhread 


Idfhread 


Idgetname 


Idgetname 


Idlinit 


Idlread 



Description 

Convert formatted output. 

Standard buffered input/output package. 

Issue a shell command. 

Create a name for a temporary file. 

Create a temporary file. 

Create a name for a temporary file. 

Push character back into input stream. 

Print formatted output of a varargs 
argument list. 

Print formatted output of a varargs 
argument list. 

Print formatted output of a varargs 
argument list. 



Verify program assertion. 

Fast main memory allocator. 

CRT screen handling and optimization 
package. 

Fast main memory allocator. 

Close a common object file. 

Read the archive header of a member of 
an archive file. 

Open a common object file for reading. 

Close a common object file. 

Read the file header of a common object 
file. 

Retrieve symbol name for common object 
file symbol table entry. 

Manipulate line number entries of a 
common object file function. 
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Function 
idlitem 

Idlread 

idiseek 

Idniseek 

Idnrseek 

Idnshread 

Idnsseek 

Idohseek 

Idopen 
Idrseek 

Idshread 

Idsseek 

Idtbindex 

Idtbread 

Idtbseek 

logname 
mallinfo 

malloc 



Library Functions (Cont.) 
Reference 

Idlread 

Idiread 
idiseek 
Idiseek 
Idrseek 
Idshread 



Idohseek 

idopen 
Idrseek 

Idshread 

idsseek 

idtbindex 

Idtbread 

idtbseek 

logname 

malloc (fast version) 



Description 

Manipulate line number entries of a 
common object file function. 

Manipulate fine number entries of a 
common object file function. 

Seek to line number entries of a section 
of a common object file. 

Seek to line number entries of a section 
of a common object file. 

Seek to relocation entries of a section of 
a common object file. 

Read an indexed/named section header 
of a common object file. 

Seek to an indexed/named section of a 
common object file. 

Seek to the optional file header of a 
common object file. 

Open a common object file for reading. 

Seek to relocation entries of a section of 
a common object file. 

Read an indexed/named section header 
of a common object file. 

Seek to an indexed/named section of a 
common object file. 

Compute the index of a symbol table 
entry of a common object file. 

Read an indexed symbol tabie entry of a 
common object file. 

Seek to the symbol table of a common 
object file. 

Return login name of user. 

Provide instrumentation describing space 
usage for malloc (fast version). 



malloc (fast version) Fast main memory allocator. 
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Function 


Reference 


Description 


mallopt 


malloc (fast version) 


Provide for control over the 

II 141 |t_ 1 _ _ -lit*— « 

malloc) 1) allocation algorithm. 


ocurse 


ocurse 


Optimized screen functions. 


ofChangeFileLength 


ofCreate 


Reset length of a Blub tile. 


ofCloseAIIFiles 


ofOpenFile 


Close all BIOS files. 


ofCloseFile 


ofOpenFile 


Close a BTOb tile. 


ofCrDir 


ofDir 


Lreate a ts i Uo oireciory. 


ofCreate 


ofCreate 


Create a BTOS file. 


ofDelete 


ofCreate 


Delete a BTOS file. 


nfniriir 


ofDir 


Delete an empty BTOS directory. 


nffiPtFtlpStatus 


ofStatus 


Get BTOS file information. 


nfflnpnFite 


ofOpenFile 


Open a BTOS file. 


ofRead 


ofRead 


Input one or more sectors from a 
BTOS file. 


ofReadDirSector 


ofDir 


Read a single BTOS 512-byte 
directory sector. 


ofRename 


ofRename 


Rename a BTOS file. 


ofSetFileStatus 


ofStatus 


Set BTOS file information. 


ofWrite 


ofRead 


Output one or more sectors to a 
biuo rue. 


quAdd 


quAdd 


KAA n natal antm in 9 RTfl^ flllOIIP 

AGO a new eniry iu a d i uo queue. 


quReadKeyed 


quRead 


Examine a BTOS queue. 


quReadNext 


quRead 


Examine a BTOS queue. 


quRemove 


quRemove 


Take back a BTOS queue request. 


regcmp 


regcmp 


Compile a regular expression. 


regex 


regcmp 


Execute a regular expression. 


sgeii 


sputl 


Access long integer data in a 
machine-dependent fashion. 
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Function 


Reference 


Description 


spawnlp 


spawn 


Execute a process on a specific 
Application Processor. 


spawnvp 


spawn 


Execute a process on a specific 
Application Processor. 


sputl 


sputl 


Access long integer data in a 
machine-dependent fashion. 


spwait 


spwait 


Wait for a spawned process to 

tprminatp 

ici inmate 


swaplong 


swapshort 


Translate byte orders to 
Motorola /I ntpl 

iiivu/iuiii/ unci* 


swapshort 


swapshort 


Translate byte orders to 
Motorola/Intel. 


tgetent 


termcap 


Get terminal entry. 


tgetflag 


termcap 


Determine if a terminal has boolea 

ranahilitv 


tgetnum 


termcap 


Get value of terminal numeric 
caoabilitv 


tgetstr 


termcap 


interpret vaiue or terminal string 
capability. 


tgoto 


termcap 


Move cursor. 


tputs 


termcap 


Direct output of string returned by 
tgetstr or tgoto. 


wmgetid 


wmgetid 


Get window ID. 


wmlayout 


uumlavniit 


Get terminal's window layout. 


wmop 


wmop 


Window management operations. 


wmsetid 


wmsetid 


Associate a file descriptor with a 
window. 


wmsetids 


wmsetids 


Associate a file descriptor with a 
window. 
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Definitions 



null character 



character 



character array 

null-terminated 
character array 

string 



Any bit pattern able to fit into a byte on the machine. 
A character with value 0, represented in the C language as '\0.' 
A sequence of characters. 

A sequence of characters, the last of which is the null character. 



a designation for a null-terminated character array. 



null string 
NULL pointer 



A character array containing only the null character. 



The value that is obtained by casting 0 into a pointer. The 
C language guarantees that this value will not match that of 
any legitimate pointer, so many functions that return 
pointers do so to indicate errors. 



NULL 



Defined as 0 in <stdio.h>; you can include your own 
definition if you are not using <stdio.h>. 



Files 



/lib/libc.a 
/lib/libm.a 

Diagnostics 

Functions in the Math Library may return the conventional 
values 0 or HUGE (the largest single-precision floating-point 
number) when the function is undefined for the given 
arguments or when the value is not representable. In these 
cases, the external variable errno (see intra in Section 2) is set 
to the value EDOM or ERANGE. 
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Caution 

Many of the functions in the libraries call and/or refer to 
other functions and external variables described in this 
section and in Section 2 (System Calls). If a program 
inadvertantly defines a function or external variable with the 
same name, the presumed library version of the function or 
external variable may not be loaded. The lint program 
checker (see Section 1) reports name conflicts of this kind as 
"multiple declarations" of the names in question. Definitions 
for Section 2 and for Standard C Library and Standard I/O 
functions of Section 3 are checked automatically. Other 
definitions can be included by using the -I option (for 
example, -Im includes definitions for the Math Library, libm). 
Use of lint is highly recommended. 

See Also 

ar, cc. Id, nm in Section 1 ; intro in Section 2; stdio. 
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Name 

a64l, 164a - convert between long integer and base-64 
ASCII string 

Format 

long a64l (5) 
char • s ; 

char • I 64a ( / ) 
long / : 

Description 

These functions are used to maintain numbers stored in 
base-64 ASCII characters. This is a notation by which long 
integers can be represented by up to six characters; each 
character represents a "digit" in a radix-64 notation. 

The characters used to represent "digits" are . for 0, / for 1 , 
0 through 9 for 2-1 1 , A through Z for 12-37, and a through 
z for 38-63. 

a64l takes a pointer to a null-terminated base-64 
representation and returns a corresponding long value. If the 
string pointed to by s contains more than six characters, a64l 
will use the first six. 

I64a takes a long argument and returns a pointer to the 
corresponding base-64 representation. If the argument is 0, 
I64a returns a pointer to a null string. 

Known Problems 

The value returned by I64a is a pointer into a static buffer, 
the contents of which are overwritten by each call. 
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Name 

abort - generate an IOT fault 

Format 

i n t abort ( ) 

Description 

The abort function first closes all open files, if possible, then 
causes an IOT signal to be sent to the process. This usually 
results in termination with a core dump. 

It is possible for abort to return if SIGIOT is caught or ignored, 
in which case the value returned is the same as that of the 
kill system call. 

Diagnostics 

If SIGIOT is neither caught nor ignored, and the current 
directory is writable, a core dump is produced, and the 
message "abort - core dumped" is written by the shell. 



See Also 

adb in Section 1; exit, kill, signal in Section 2. 
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Name 

abs - return integer absolute value 

Format 

I n t abs ( / ) 

I n t / ; 

Description 

The abs function returns the absolute value of its integer 
operand. 

Known Problems 

In two's-complement representation, the absolute value of 
the negative integer with the largest magnitude is undefined. 
Some implementations trap this error, but others simply 
ignore it. 



See Also 

floor. 
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Name 

assert - verify program assertion 

Format 

^include <assert.h> 

assert ( express i on) 
Int expression; 

Description 

This function is useful for putting diagnostics into programs. 
When it is executed, if expression is false (zero), assert prints 

"Assertion failed: expression, file xyz, line nnn" 

on the standard error output and aborts. In the error 
message, xyz is the name of the source file and nnn is the 
source line number of the assert statement. 

Compiling with the preprocessor option -DNDEBUG (see cpp in 
Section 1 ), or with the preprocessor control statement 
"#define NDEBUG" ahead of the "#include <assert.h>" 
statement, will stop assertions from being compiled into the 
program. 

See Also 

cpp in Section 1 ; abort. 



Library Functions 



3-21 



atof 



Name 

atof - convert ASCII string to floating-point number 



Format 

double a t o f ( np t r ) 
char * npt r ; 



Description 

The atof function converts a character string pointed to by 
nptr to a double-precision floating-point number. The first 
unrecognized character ends the conversion, atof recognizes 
an optional string of white-space characters, then an optional 
sign, then a string of digits optionally containing a decimal 
point, then an optional e or E followed by an optionally 
signed integer. If the string begins with an unrecognized 
character, atof returns the value zero. 



Diagnostics 

When the correct value would overflow, atof returns HUGE, 
and sets errno to ERANGE. Zero is returned on underflow. 



See Also 

scanf. 
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Name 

jO, jl, jn, yO, y1, yn - Bessel functions 

Format 

#i nc I ude <ma t h . h> 

double jO <x) 
doub I e x ; 

doub I e j 1 (x) 
doub I e x ; 

double |n (n. x) 
I nt n; 
doub I e x ; 

doub I e yO ( x) 
double x; 

double y1 (x) 
doub I e x ; 

double yn (n, x) 
int n; 
double x; 

Description 

jO and jl return Bessel functions of x of the first kind of 
orders 0 and 1 respectively, j/7 returns the Bessel function of 
x of the first kind of order n. 

yO and yl return Bessel functions of x of the second kind of 
orders 0 and 1 respectively, yn returns the Bessel function of 
x of the second kind of order n. The value of x must be positive 
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Diagnostics 

Non-positive arguments cause yO, yl and yn to return the 
value -HUGE and to set errno to EDOM. In addition, a 
message indicating DOMAIN error is printed on the standard 
error output. 

Arquments too large in magnitude cause jO, j1, yO and y1 to 
return zero and to set errno to ERANGE. In addition, a 
message indicating TLOSS error is printed on the standard 
error output. 

These error-handling procedures may be changed with the 
function matherr. 



See Also 

matherr 
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Name 

bsearch - binary search a sorted table 

Format 

#i nc I ude <search . h> 

char 'bsearch ((char •> key, (char •) basg , net 

si zeot ( -key) , compar) 
uns i gned ne I ; 
i n t ( * compa r ) ( ) ; 



Description 

The bsearch function is a binary search routine generalized 
from Knuth (6.2.1) Algorithm B. It returns a pointer into a 
table indicating where a datum may be found. The table must 
be previously sorted in increasing order according to a 
provided comparison function. Key points to a datum 

ITthohVc 0 b M° U9h uV n l he table " Base P° ints t0 the dement 
at the base of the table. Nel is the number of elements in the 
table Compar is the name of the comparison function, which 
is called with two arguments that point to the elements 
being compared. The function must return an integer less 
than, equal to, or greater than zero as, accordingly, the first 
argument is to be considered less than, equal to, or greater 
than the second. a 



Example 

The following example searches a table containing pointers 
nr^rtT iTk 3 '" 19 ,^ 8 String and its len 9 th - The table is 
each entry V 0n ^ ' m the n ° de pointed to b V 

This code fragment reads in strings and either finds the 
corresponding node and prints out the string and its length 
or prints an error message. ' 
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^include <stdio.h> 
#include <search.h> 

#def ine TABS I ZE 1000 

struct node ( 

char 'string; 
i n t I eng t h ; 

1 : 

struct node t ab I e [TABS I ZE J ; 



/•these are stored in table*/ 



/•table to be searched*/ 



( 

struct node - node_ptr, node; 

int node_compare( ) ; /'routine to compare 2 nodes*/ 

char st r_space[20] ; /'space to read string into'/ 



node. string - str_space; 

while (scanf ( "%" . node. string) !- EOF) { 

node_ptr - (struct node ' ) bsea r c h ( ( cha r *)(&noda), 

(char *)table, TABS I ZE , 
s I zeo f ( s t r uc t node). node_compa r e ) ; 
i f (node_pt r I - NULL) ( 

(void)prlntf('string - %20s. length - %d\n", 

node_pt r->st r ing, node_pt r->length) ; 

} else { 

(vold)pr i nt f ( "not found: %s\n", node . s t r I n g ) ; 

) 

) 

! 

This routine compares two nodes based on an 
alphabetical ordering of the string field. 

•/ 
I n t 

nod e_compa r e ( node 1 , node2) 
struct node *node1, "node2; 

return s t r cmp ( node 1 ->s t r i ng . node2 ->s t r i ng ) ; 

) 
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The pointers to the key and the element at the base of the 
table should be of type pointer-to-element, and cast to tvoe 
pointer-to-character. 

The comparison function need not compare every byte so 
arbitrary data may be contained in the elements in addition to 
the values being compared. 

Although declared as type pointer-to-character, the value 
returned should be cast into type pointer to element. 

Diagnostics 

A NULL pointer is returned if the key cannot be found in the table . 

See Also 

hsearch, Isearch, qsort, tsearch. 



Library Functions 



3-27 



clock 



Name 

clock - report CPU time used 



Format 

long c I ocK ( ) ; 



Description 

The clock function returns the amount of CPU time (in 
microseconds) used since the first call to clock. The time 
reported is the sum of user and system times of the calhng 
process and its terminated child processes for which it has 
executed a wait system call or system library function. The 
return value will vary based on system usage. 
The resolution of the clock is 16.667 microseconds on 
CENTIX processors. 

Known Problems 

The value returned by clock is defined in milliseconds for 
compatibility with systems that have CPU clocks with a 
much higher resolution. Because of this, the value returned 
will wrap around after accumulating 2147 seconds of CPU 
time (approximately 36 minutes). 



See Also 

times, wait in Section 2; system. 
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Name 



toupper, tolower, _toupper, _tolower, toascii - translate 
characters 



Format 

# i nc I ude <c t ype . h> 

i n l t ouppe r ( c) 

int c ; 

I nt to lower ( c) 
int c; 

i n t _t ouppe r ( c) 
int c; 

Int t o I owe r ( c) 

Int c ; 

Int t oasc II ( c) 
Int c; 



Description 

The toupper and tolower functions have as domain the range of 
the getc library function: the integers from -1 through 255 If 
the argument of toupper represents a lower case letter the 
result is the corresponding upper case letter. If the argument 
of tolower represents an upper case letter, the result is the 
corresponding lower case letter. All other arguments in the 
domain are returned unchanged. 

The macros .toupper and .tolower accomplish the same thinq 
as toupper and tolower but have restricted domains and are 
taster, .toupper requires a lower case letter as its argument' 
its result is the corresponding upper case letter. The macro 
-tolower requires an upper case letter as its argument its 
result is the corresponding lower case letter. Arguments 
outside the domain cause undefined results 
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toascii yields its argument with all bits turned off that are not 
part of standard ASCII character; it is intended for 
compatibility with other systems. 

See Also 

ctype, getc. 
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Name 

crypt, setkey, encrypt - generate DES encryption 



Format 




char 'crypt 


(key, salt) 


char 'key, ' 


salt; 


void setkey 


{key) 


char 'key; 




void encrypt 


(block, edflag) 


char 'block; 


Int eat lag; 





Description 

The crypt function is the password encryption function It is 
based on the NBS Data Encryption Standard (DES), with 
variations intended (among other things) to frustrate use of 
hardware implementations of the DES of key hardware 
implementations of the DES for key search. 

Key is a user's typed password. Sait is a two-character strinc 
chosen from the set [a-zA-ZO-9./]; this string is used to 
perturb the DES algorithm in one of 4096 different ways, 
after which the password is used as the key to repeatedly 
encrypt a constant string. The returned value points to the 
encrypted password. The first two characters are the salt itself. 

The setkey and encrypt entries provide (rather primitive) access 
to the actual DES algorithm. The argument of setkey is a 
character array of length 64 containing only the characters 
with numerical value 0 and 1 . If the string is divided into 
groups of 8, the low-order bit in each group is ignored; this 
gives a 56-bit key which is set to the machine. This is the 
key that will be used with the above mentioned algorithm to 
encrypt or decrypt the string block with the function encrypt 
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The argument to the encrypt entry is a character array of 
length 64 containing only the characters with numerical value 
0 and 1 . The argument array is modified in place to a similar 
array representing the bits of the argument after having been 
subjected to the DES algorithm using the key set by setkey. If 
edflag is zero, the argument is encrypted; if non-zero, it is 
decrypted. 

Known Problems 

The return value points to static data that are overwritten by 
each call. 

See Also 

login, passwd in Section 1 ; getpass; passwd in Section 4. 
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Name 

ctermid - generate file name for terminal 

Format 

#include <stdio.h> 

char 'ctermid (s) 
char * s ; 

Description 

The ctermid function generates the path name of the 
controlling terminal for the current process, and stores it in a 
string. 

If s is a NULL pointer, the string containing the path name is 
stored in an internal static area, the contents of which are 
overwritten by the next call to ctermid, and the address of 
which is returned. Otherwise, s is assumed to point to a 
character array of at least L ..ctermid elements; the path 
name is placed in this array and the value of s is returned. 
The constant L _ctermid is defined in the <stdio.h> header file. 

The difference between ctermid and ttyname is that ttyname 
must be handed a file descriptor and returns the actual name 
of the terminal associated with that file descriptor, while 
ctermid returns a string (/dev/tty) that will refer to the terminal 
if used as a file name. Thus, ttyname is useful only if the 
process already has at least one file open to a terminal. 

See Also 

ttyname. 



Library Functions 



3-33 



ctime 

Name 

ctime. localtime, gmtime, asctime, tzset - convert date and 
time to string 

Format 

# I nc I ude < t ime . h> 

char • c t ime {c I ock) 
long ' c lock; 

struct tm 'localtime [clock) 
long 'clock: 

struct tm •gmtime {clock) 
long ' c lock : 

char •asctime ( tm) 
struct tm • tm: 

extern long tlmazone 

extern int daylight 

extern char * r zname[2] : 

void tzsef ( ) 

Description 

The ctime function converts a long integer, pointed tc i by 
clock, representing the time in seconds since OOmoo GMT. 
January 1, 1970, and returns a pointer to a 26-character 
Sg of the following form. All fields have constant width. 

Sun Sep 16 01:03:52 1973\n\0 
localtime and gmtime return pointers to "tm" structures 
described below, localtime corrects for the time zc jneand 
possible Daylight Savings Time; gmt.me converts direc y to 
Greenwich Mean Time (GMT), which is the t.me CENTIX uses, 
asctime converts a "tm" structure to a 26-characte J stringy 
shown in the above example, and returns a pointer to the string. 
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Declarations of all the functions and externals, and the "tm" 

ssss^zr the <timeh> header The ™ 

struct tm { 

int tm_sec; /• seconds ( 0 - 59 )• / 

int tm_min; / "ml nu t es ( 0 - 59 ) • / 

int tm_hour; / ' hour s ( 0- 23) • / 

int tm_mday; /-day of mon t h ( 1 - 31 ) • / 

mt tm_mon; /-month of year (0-11)-/ 

Int tm_year; /'year - 1900'/ 

int tm_wday; r<Say o1 week(Sunday . 0)'/ 

Int tm_yday; r<Say of yea r ( 0 - 365 ) • / 

int t m_ I s d s t ■ 

} ; 

TmJsdst is nonzero if Daylight Savings Time is in effect. 
The external long variable timezone contains the difference in 
seconds between GMT and local standard time (in EST 
t'mezone* 5'60'60). The external variable 7ayHghtfs 
nonzero if and only if the standard U.S.A. Dayhght Savings 
Tune conversion should be applied. The program knows 
about the peculiarities of this conversion in 1974 and 1975 
if necessary, a table for these years can be extended. 

If an environment variable named TZ (time zone) is present 
«*» uses the contents of the variable to overtime the 
default timezone. The value of TZ must be a three-letter 
timezone name, followed by a number representing the 

hSTX bet nl en ,OCa ' time and Greenwich Mean lime in 
hours followed by an optional three-letter name for a 

woufbeTsVBmT^n^T 6 ' ?" Settin 9 for New Jersey 
wouia De tb I bbDT. Setting TZ changes the value of thp 

external variables timezone and daylight^ addition the Le 
zone names contained in the external variable 
char •tzname[2] = {"EST","EDT"}; 

are set from the environment variabel TZ. The function tzset 
sets these external variables from TZ; tzset is caS by 
asctime and may also be called explicitly by the user. 
Note that in most installations, TZ is set by default when the 
in section"',.' 0 3 ^ " the l0Cal ™> (see 
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Known Problems 

The return values point to static data whose content is 
overwritten by each call. 

See Also 

time in Section 2; getenv; profile in Section 4; environ i 
Section 5. 
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Name 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace. 
ispunct, isprint, isgraph, iscntrl, isascii - classify characters 

Format 



Description 

These macro functions classify character-coded integer 
values by table lookup. Each is a predicate returning nonzero 
for true, zero for false. The function isascii is defined on all 
integer values; the rest are defined only where isascii is true 
and on the single non-ASCII value EOF (-1 - see stdio) 

isa'pha c is a letter. 

isu PP er c is an upper case letter. 

'slower c is a lower case letter. 

isdigit c is a digit [from 0 to 9]. 

isxdigit c is a hexadecimal digit [0-9], [A-F] and [a-f]. 




int isalpha ( c ) 
i n t c ; 



isalnum 



c is an alphanumeric (letter or digit). 

c is a space, tab, carriage return, new-line, vertical tab, or 
form-feed. 



isspace 



ispunct 



c is a punctuation character (neither control nor 
alphanumeric). 



isprint 



c is a printing character, ASCII octal code 040 (space) 
through 0176 (tilde). 



isgraph 



cis a printing character, like isprint except it is false for space. 
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iscntr | c is a delete character (0177) or an ordinary control 

character (less than 040). 

isasc ii c is an ASCII character code less than 0200. 



Diagnostics 

If the argument to any of these macros is not in the domain 
of the function, the result is undefined. 
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Name 

curses - CRT screen handling and optimization package 

Format 

# include <curses.h> 

cc [flags] files -Icurses [ libraries] 

Description 

These routines give the user a method of updating screens 
with reasonable optimization. In order to initialize the 
routines, the routine initscrO must be called before any of the 
other routines that deal with windows and screens are used 
The routine endwinO should be called before exiting. To get 
character-at-a-time input without echoing (most interactive, 
screen-oriented programs want this), after calling initscrO vou 
should call "nonl(); cbreakO; noechol);" 

The full curses interface permits manipulation of data 
structures called windows, which can be thought of as two 
dimensional arrays of characters representing all or part of a 
CRT screen. A default window called stdscr is supplied, and 
others can be created with newwin. Windows are referred to 
by variables declared "WINDOW V the type WINDOW is 
defined in curses. h to be a C structure. These data structures 
are manipulated with functions described below, among 
which the most basic are move and addch. (More general 
versions of these functions are included with names 
beginning with w, allowing you to specify a window The 
routines not beginning with w affect stdscr.) Then refreshO is 
called, telling the routines to make the user's CRT screen 
look like stdscr. 

Mini-Curses is a subset of curses which does not allow 
manipulation of more than one window. To invoke this 
subset, use -DMINICURSES as a cc option. This level is 
smaller and faster than full curses. 
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If the environment variable TERMINFO is defined, any 
program using curses will check for a local terminal definition 
before checking in the standard place. For example, if the 
standard place is /usr/lib/terminfo, and TERM is set to 
"vt100," then normally the compiled file is found in 
/usr/lib/terminfo/v/vt100. {The "v" is copied from the first 
letter of "vt100" to avoid creation of huge directories.) 
However, if TERMINFO is set to /usr/mark/myterms, curses 
will first check /usr/mark/myterms/v/vt100, then, if that 
fails, /usr/lib/terminfo/v/vt100. This is useful for developing 
experimental definitions or when write permission in 
/usr/lib/terminfo is not available. 

Functions 

Routines listed in Table 3-2 may be called when using the full 
curses. Those marked with an asterisk may be called when 
using Mini-Curses 

Table 3-2 Curses Routines 



addstr(ch)* 



addstr(str)* 
attroffjattrs)* 
attron(attrs)* 
attrset(attrs)* 
baudrateO* 
beep))* . 



box(win, vert, hor) 



clearj) 

clearok{win, bf) 



clrtobotO 
clrtoeolO 
cbreak{)" 



delay_output(ms)* 



Add a character to stdscr {like putchar) 

(wraps to next line at end of line). 

Calls addch with each character in str. 

Turns off attributes named. 

Turns on attributes named. 

Set current attributes to attrs. 

Current terminal speed. 

Sound beep on terminal. 

Draw a box around the edges of win. Vert and 

hor are chars to use for vert, and horiz. edges 

of box. 

Clear stdscr. 

Clear screen before next redraw of win. 
Clear to bottom of stdscr. 
Clear to end of line on stdscr. 
Set break mode. 

Insert ms millisecond pause in output. 
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Table 3-2 Curses Routines (Coi 

delch() 

deleteln() 

delwin(win) 

doupdatef) 

echo!)* 

endwin()* 

erase() 

erasechar() 

fixterm() 

flash() 

flushinpO* 

getch()* 

getstr(str) 

gettmodej) 

getyxfwin, y, x) 

has_ic() 

hasJIO 

idlok(win, hf)* 

inch)) 

initscr))* 

insch(c) 

insertlnf) 

intrflush(win, bf) 

keypad(win, bf) 

killcharf) 

leaveok(win, flag) 



longnamef) 
metafwin, flag)' 
move(y, x)* 
mvaddchfy, x, ch) 
mvaddstr(y, x, str) 
mvcurfoldrow, oldcol, 
newrow, newcol) 



:.) 

Delete a character. 
Delete a line. 
Delete win. 

Update screen from all wnoutrefresh. 
Set echo mode. 
End window modes. 
Erase stdscr. 

Return user's erase character. 

Restore tty to "in curses" state. 

Flash screen or beep. 

Throw away any typeahead. 

Get a character from tty. 

Get a string through stdscr. 

Establish current tty modes. 

get (y, *) co-ordinates. 

True if terminal can do insert character. 

True if terminal can do insert line. 

Use terminal's insert/delete line if bf !- 0. 

get char at current [y, *) co-ordinates. 

Initialize screens. 

Insert a char. 

Insert a line. 

Interrupts flush output if bf is TRUE. 

Enable keypad input. 

Return current user's kill character. 

OK to leave cursor anywhere after refresh if 

flag !- 0 for win, otherwise cursor must be 

left at current position. 

Return verbose name of terminal. 

Allow meta characters on input if flag != 0. 

Move to {y, ,r) on stdscr. 

move(x, Jf) then addch(ch). 

Similar... 

Low level cursor motion. 
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Like delch, but move(y, x) first. 
And so on... 
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Table 3-2 Curses Routines (Cont.) 

mvdelch|y. x) 
mvgetch(y, x) 
mvgetstr(y,x) 
mvinch(y,x) 
mvinsch(y, x, c) 
mvprintw{y, x, fmt, args) 
mvscanwjy, x, fmt, args) 
mvwaddch(win, y, x, ch) 
mvwaddstr(win, y, x, str) 
mvwdelch(win, y, x) 
mwvgetch(win, y, x) 
mvwgetstr(win, y, x) 
mvwin(win, by, bx) 
mwvinchlwin, y, x) 
mvwinseh(win, y, x, c) 
mvwprintwlwin, y, x, fmt, args) 
mvwscanwjwin, y, x, fmt, args) 
newpadlnlines, ncols) 
newtermltype, fd) 

newwin(lines, cols, begin_y, 
begin_x) 
nil)' 

nocbreak()* 
nodelay(win, bf) 
noechoO* 
nonllT 
norawO* 

overlay(win1 , win2) 
overwrite(win1, win2) 
pnoutrefresh(pad, pminrow, 
pmincol, sminrow, smincol, 
smaxrow, smaxcol) 
prefresh{pad, pminrow, pmincol, 
sminrow, smincol, smaxrow, 
smaxcol) 

printw(fmt, arg1, arg2, ...) 
raw{)* 
refresh!.)* 
resetterml,)* 
resettyO" 
savetermO* 



Create a new pad with given dimensions. 
Set up a new terminal of given type to output 
on fd. 

Create a new window. 

Set newline mapping. 
Unset cbreak mode. 

Enable nodelay input mode through getch. 

Unset echo mode. 

Unset newline mapping. 

Unset raw mode. 

Overlay winl on win2. 

Overwrite winl on top of win2. 

Like prefresh, but with no output until 

doupdate called. 

Refresh from pad starting with given upper left 
corner of pad with output to given portion of 
screen. 

printf on stdscr. 
Set raw mode. 

Make current screen look like stdscr. 
Set tty modes to "out of curses" state. 
Reset tty flags to stored value. 
Save current modes as "in curses" state. 
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Table 3-2 Curses Routines (Cont.) 



savettyO* 

scanw(fmt, arg1, arg2, ...) 
scroll(win) 
scrollok(win, flag) 
set_term(newj 
setscrregft, b) 
setterm(type) 

setuptermfterm, filenum, errret) 

standend()* 

standout!)* 

subwinfwin, lines, cols, begin_y, 

begin_x) 

touchwin(wm) 

traceoff() 

traceon)) 

typeahead(fd) 

unctrl(ch)* 

waddch(win, ch) 

waddstr(win, str) 

wattroffjwin, attrs) 

wattron(win, attrs) 

wattrset(win, attrs) 

wclear(win) 

wclrtobot(win) 

wclrtoeol(win) 

wdelchjwin, c) 

wdeletelnfwin) 

werase(win) 

wgetchjwin) 

wgetstrfwin, str) 

winch(win) 

winsch(win, c) 

winsertln(win) 

wmove(win, y, x) 

wnoutrefresh(win) 

wprintw(win, fmt, argl, arg2, ...) 

wrefresh(win) 

wscanwfwin, fmt, argl, arg2, ...) 
wsetscrreg(win, t, b) 
wstandend(win) 
wstandout(win) 



Store current tty flags. 

scanf through stdscr. 

Scroll win one line. 

Allow terminal to scroll if flag !- 0. 

Now talk to terminal new. 

Set user scrolling region to lines t through b. 

Establish terminal with given type. 

Set up terminal. 

Clear standout mode attribute. 

Set standout mode attribute. 

Create a subwindow. 

Change all of win. 

Turn off debugging trace output. 

Turn on debugging trace output. 

Use file descriptor fd to check typeahead. 

Printable version of ch. 

Add char to win. 

Add string to win. 

Turn off attrs in win. 

Turn on attrs in win. 

Set attributes in win to attrs. 

Clear win. 

Clear to bottom of win. 
Clear to end of line on win. 
Delete char from win. 
Delete line from win. 
Erase win. 

Get a char through win. 

Get a string through win. 

Get a char at current (y, x) in win. 

Insert char into win. 

Insert line into win. 

Set current (y, at) co-ordinates on win. 

Refresh but no screen output. 

printf on win. 

Make screen look like win. 

scanf through win. 

Set scrolling region of win. 

Clear standout attribute in win. 

Set standout attribute in win. 
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Terminfo Level Routines 

The routines in Table 3-3 should be called by programs 
wishing to deal directly with the terminfo database. Due to 
the low level of this interface, it is discouraged. Initially, 
setupterm should be called. This will define the set of terminal 
dependent variables defined in terminfo (see Section 4). The 
include files <curses.h> and <term.h> should be included to 
get the definitions for these strings, numbers, and flags. 
Parameterized strings should be passed through tparm to 
instantiate them. All terminfo strings (including the output of 
tparm) should be printed with tputs or putp. Begore exiting, 
resetterm should be called to restore the tty modes. (Programs 
desiring shell escapes or suspending with control Z can call 
resetterm before the shell is called, and fixterm after returning 
from the shell.) 

Table 3-3 Terminfo Level Routines 



fixterm() 



resetterm!) 

setupterm(term, fd, re) 



tparm(str, pi, p2, .... p9) 
tputs(str, affent, putc) 



putp(str) 



vidputs(attrs. putc) 



vidattr(attrs) 



Restore tty modes for terminfo use (called by 
setupterm). 

Reset tty modes to state before program entry. 
Read in database. Terminal type is the 
character string term, all output is to CENTIX 
file descriptor fd. A status value is returned in 
the integer pointed to by re: 1 is normal. The 
simplest call would be setupterm(0, 1, 0), 
which uses all defaults. 
Instantiate string str with parms pi. 
Apply padding info to string sfr. Affent is the 
number of lines affected, or 1 if not applicable. 
Putc is a putehar-like function to which the 
characters are passed, one at a time. 
Handy function that calls tputs(str, 1, 
putchar). 

Output the string to put terminal in video 
attribute mode attrs, which is any combination 
of the attributes listed below. Chars are 
passed to putehar-like function putc. 
Like vidputs but outputs through putchar 
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Termcap Compatibility Routines 

These routines were included as a conversion aid for 
programs that use termcap. Their parameters are the same 
as for termcap. They are emulated using the terminfo 
database. They may go away at a later date. 



Table 3-4 Termcap Compatibility 

tgetentfbp, name) 
tgetflag(id) 
tgetnum(id) 
tgetstrfid, area) 
tgoto(cap, col, row) 
tputs(cap, affcnt, fn) 



Routines 

Look up termcap entry for name. 

Get boolean entry for id. 

Get numeric entry for id. 

Get string entry for id. 

Apply parms to given cap. 

Apply padding cap calling fn as putchar. 



Attributes 

The video attributes in Table 3-5 can be passed to the 
functions attron. attroff, attrset. 



Table 3-5 Video Attributes 

A-STANDOUT 

AJUNOERUNE 

AJEVERSE 

A_BLINK 

A_DIM 

A_B0LD 

A_BLANK 

A_PR0TECT 

A_ALTCHARSET 



Terminal's best highlighting mode. 

Underlining. 

Reverse video. 

Blinking. 

Half bright. 

Extra bright or bold. 

Blanking (invisible). 

Protected. 

Alternate character set. 
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Function Keys 

The function keys in Table 3-6 might be returned by getch if 
keypad has been enabled. Note that not all of these are 
currently supported, due to lack of definitions in terminfo or 
the terminal not transmitting a unique code when the key is 
pressed. 



Table 3-6 Curses Function Keys 
Name Value 



KEY_BREAK 

KEY_D0WN 

KEY-UP 

KEYJ.EFT 

KEY-RIGHT 

KEY_H0ME 

KEY-BACKSPACE 

KEY_F0 

KEY_F(n) 

KEY_DL 

KEYJL 

KEY_DC 

KEY-IC 

KEY_EIC 

KEY-CLEAR 

KEY-EOS 

KEY-EOL 

KEY-SF 

KEY_SR 

KEY-NPAGE 

KEY_PPAGE 

KEY_STAB 

KEY-CTAB 

KEY-CATAB 

KEY-ENTER 

KEY-SRESET 

KEY_RESET 

KEY_PR1NT 

KEYJLL 



0401 
0402 
0403 
0404 
0405 
0406 
0407 
0410 

(KEY-F0 + (n» 

0510 

0511 

0512 

0513 

0514 

0515 

0516 

0517 

0520 

0521 

0522 

0523 

0524 

0525 

0526 

0527 

0530 

0531 

0532 

0533 



Key Name 

Break key (unreliable). 
The four arrow keys... 



Home key (upward + left arrow). 

Backspace (unreliable). 

Function keys. Space for 64 is 

reserved. 

Formula for in. 

Delete line. 

insert line. 

Delete character. 

Insert char or enter insert mode. 

Exit insert char mode. 

Clear screen. 

Clear to end of screen. 

Clear to end of line. 

Scroll 1 line forward. 

Scroll 1 line backwards (reverse). 

Next page. 

Previous page. 

Set tab. 

Clear tab. 

Clear all tabs. 

Enter or send (unreliable). 

Soft (partial) reset (unreliable). 

Reset or hard reset (unreliable). 

Print or copy. 

Home down or bottom left. 
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Caution 

The plotting library plot and the curses library curses both use 
the names erase() and move(). The curses versions are 
macros. If you need both libraries, put the plot code in a 
different source file than the curses code, and/or #undef 
move() and erase() in the plot code. 

See Also 

terminfo in Section 4; XE 500 CENTIX System Programming 
Guide. 
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Name 

cuserid - get character login name of the user 



Format 

# i nc I ude <s t d i o . h> 

char 'cuserid (s) 
char " s ; 



Description 

The cuserid function gets the user's login name as found in 
/etc/utmp. If the login name cannot be found, cuserid gets the 
login name corresponding to the user ID of the process. If s 
is a NULL pointer, this representation is generated in an 
internal static area, the address of which is returned. 
Otherwise, s is assumed to point to an array of at least 
L .cuserid characters; the representation is left in this array. 
The constant L _cuserid is defined in the <stdio.h> header file. 



Diagnostics 

If the login name cannot be found and the process's owner 
lacks a password file entry, cuserid returns a NULL pointer; if s 
is not a NULL pointer, a NULL character (\0) will be placed at s[0]. 



See Also 

getlogin, getpwent. 
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Name 

dial, undial - establish and release an out-going terminal 
line connection. 



Format 

# i nc I ude <d i a I . h> 

i n t dial [call) 
CALL call; 

vo i d und i a I ( fa) 
int fd; 



Description 

The dial library function returns a file descriptor for a terminal 
line open for read/write. The argument to dial is a CALL 
structure (defined in the <dial.h> header file). 

When finished with the terminal line, the calling program 
must invoke undial to release the semaphore that has been 
set during the allocation of the terminal device. 

The definition of CALL in the <dial.h> header file is: 



t ypede f struct { 

struct t e rm l o • a t t r ; 

Int baud; 
I n t speed ; 

cha r 'line; 

cnar 'telno 

_ modem; 

char 'device; 

I n t dev_l en ; 

I CALL; 



/•pointer to termio 

attribute struct*/ 

/'transmission data rate*/ 

/*212A modem: low-300, 
h i gh-1 200* / 

/'device name lor out-going 
line*/ 

/ * po Inter to telno digits 

string'/ 
/'specify modem control for 

direct li nes * / 
/'will hold the name of the 

dev I ce used to make 

a connec t i on * / 
/'the length of the device 

used to make 

connec t I on ' / 
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The CALL element speed is intended only for use with an 
outgoing dialed call, in which case its value should be either 
300 or 1200 to identify the 1 13A modem, or the high or 
low speed setting on the 212A modem. Note that the 1 13A 
modem or the low speed setting of the 212A modem will 
transmit at any rate between 0 and 300 bits per second. 
However, the high speed setting of the 212A modem 
transmits and receives at 1 200 bits per second only. The 
CALL element baud is for the desired transmission baud rate. 
For example, one might set baud to 1 1 0 and speed to 300 
(or 1 200). However, if speed is set to 1 200, baud must be 
set to high (1200). 

If the desired terminal line is a direct line, a string pointer to 
its device-name should be placed in the line element in the 
CALL structure. Legal values for such terminal device names 
are kept in the L-devices file. In this case, the value of the 
baud element need not be specified as it will be determined 
from the L-devices file. 

The telno element is for a pointer to a character string 
representing the telephone number to be dialed. The number 
must consist of the following codes: 



0-9 Dial 0-9. 

• or : Dial *. 

# or ; Dial #. 

4 second delay for second dial tone, 
w or - Wait for secondary dial tone, 

f Flash off hook for 1 second. 



On a smart modem, these symbols are translated to modem 
commands using the modem description in 
/usr/lib/uucp/modemcap. 

The CALL element modem is used to specify modem control 
for direct lines. This element should be non-zero if modem 
control is required. The CALL element am is a pointer to a 
termio structure, as defined in the termio.h header file. A 
NULL value for this pointer element may be passed to the dial 
function, but if such a structure is included, the elements 
specified in it will be set for the outgoing terminal line before 
the connection is established. This is often important for 
certain attributes such as parity and baud-rate. 
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The CALL element device is used to hold the device name 
(cul..) that establishes the connection. 

The CALL element dev /en is the length of the device name 
that is copied into the array device. 

Files 

/usr/lib/uucp/modemcap 
/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK tty-device 

Diagnostics 

On failure, a negative value indicating the reason for the 
failure will be returned. Mnemonics for these negative indices 
as listed here are defined in the <dial.h> header file. 

/"interrupt occurred*/ 

/•dialer hung (no return from write)*/ 
/'no answer within 10 seconds*/ 
/'illegal baud rate*/ 
/*acu problem (open() failure)*/ 
/•line problem (open() failure)*/ 
/'cannot open LDEVS file*/ 
/'requested device not available'/ 
/'requested device not known'/ 
/'no device available at request baud*/ 
/•no device known at request baud*/ 

Cautions 

Including the <dial.h> header file automatically includes the 
<termio.h> header file. 

The above routine uses <stdio.h>, which causes it to 
increase the size of programs, not otherwise using standard 
l/U, more than might be expected. 

See Also 

uucp in Section 1 ; alarm, read, write in Section 2; modemcap 
in Section 5; termio in Section 6. 



INIHrr - 1 

D_HUNQ - 2 

NO_ANS - 3 

ILL_BD -4 

A_PROB - 5 

L_PROB - 8 

NO_Ldv -7 

DV_NT_A - 8 

DV_NT_K - 9 

NO_BD_A - 1 0 

NO_BD K - 1 1 
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Name 

drand48, erand48, Irand48, nrand48, mrand48, jrand48, srand48, 
seed48, lcong48 - generate uniformly distributed 
pseudo-random numbers 

Format 

doub I e d r and4B ( ) 

double erand48 (xsubi) 
unsigned short x s u b i [ 3 ] ; 

I ong I r and48 ( ) 

long nrand48 {xsubi) 
unsigned short xsubi[3]; 

I ong mr and48 ( ) 

I ong ] rand48 ( xsub i ) 
unsigned short xsubl[3]; 

void srand48 (seedval) 
long seedva I ; 

unsigned short 'seed48 [seed16v) 
unsigned short seed 1 6v[ 3 ] ; 

void lcong48 (param) 
unsigned short param[7J; 



Description 

This family of library functions generate pseudo-random 
numbers using the well-known linear congruential algorithm 
and 48-bit integer arithmetic. 

The drand48 and erand48 functions return non-negative 
double-precision floating-point values uniformly distributed 
over the interval [0.0, 1 .0). 

Irand48 and nrand48 return non-negative long integers 
uniformly distributed over the interval [0, 2 31 ). 
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mrand48 and jrand48 return signed long integers uniformly 
distributed over the interval [-2 31 , 2 31 ). 

The srand48, seerJ48, and lcong48 functions are initialization 
entry points, one of which should be invoked before either 
drand48, Irand48, or mrand48 is called. (Although it is not 
recommended practice, constant default initializer values will 
be supplied automatically if drand48, Irand48, or mrand48 is 
called without a prior call to an initialization entry point.) 
Functions erand48, nrand48, and jrand48 do not require an 
initialization entry point to be called first. 

All the routines work by generating a sequence of 48-bit 
integer values, X, according to the linear congruential formula 

x n. i - (aX n + c) modm where n >= 0 

The parameter m = 2 48 ; hence 48-bit integer arithmetic is 
performed. Unless lcong48 has been invoked, the multiplier 
value a and the addend value c are given by 

a = 5DEECE66D 16 = 273673163155 8 
c = B 16 = 13 8 

The value returned by any of the functions drand48, erand48 
Irand48, nrand48, mrand48, or jrand48 is computed by first 
generating the next 48-bit X. in the sequence. Then the 
appropriate number of bits, according to the type of data 
item to be returned, are copied from the high-order (leftmost) 
bits of X. and transformed into the returned value. 

The functions drand48, Irand48, and mrand48 store the last 
48-bit X. generated in an internal buffer; that is why they 
must be initialized prior to being invoked. The functions 
erand48, nrand48, and jrand48 require the calling program to 
provide storage for the successive X values in the array 
specified as an argument when the functions are invoked. 
That is why these routines do not have to be initialized; the 
calling program merely has to place the desired initial value 
of X into the array and pass it as an argument. By using 
different arguments, functions erand48, nrand48, and jrand48 
allow separate modules of a large program to generate 
several independent streams of pseudo-random numbers, 
that is, the sequence of numbers in each stream will not ' 
depend upon how many times the routines have been called 
to generate numbers for the other streams. 
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The initializer function srand48 sets the high-order 32-bits of 
X to the 32 bits contained in its argument. The iow-order 16 
bits of X are set to the arbitrary value 330E 16 . 

The initializer function seed48 sets the value of X to the 48-bit 
value specified in the argument array. In addition, the 
previous value of X, is copied into a 48-bit internal buffer 
used only by seed48, and a pointer to this buffer is the value 
returned by seed48. This returned pointer, which can be 
ignored if it is not needed, is useful when restarting a 
program from a given point at some future time. For 
example, use the pointer to get and store the last X value, 
and then use this value to reinitialize via seed48 when the 
program is restarted. 

The initialization function lcong48 allows the user to specify 
the initial X, the multiplier value a, and the addend value c. 
Argument array element param[0-2J specifies X, param[3-5J 
specifies the multiplier a, and param[6J specifies the 1 6-bit 
addend c. After lcong48 has been called, a subsequent call to 
either srand48 or seed48 will restore the "standard" multiplier 
and addend values, a and c, specified previously. 

See Also 

rand. 
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Name 

ecvt, fcvt, gcvt - convert floating-point number to string 

Format 

char -ecvt {value, ndigit, decpt, sign) 
double value; 

int ndigit, 'decpt, 'sign; 

char -fcvt [value, ndigit, decpt, sign) 
double value; 

int ndigit, 'decpt, 'sign; 

char 'gcvt (value, ndigit. but) 
double value; 
int ndigit; 
char 'buf; 



Description 

The ecvt function converts value to a null-terminated string of 
ndigit digits and returns a pointer thereto. The high-order 
digit is non-zero, unless the value is zero. The low-order 
digit is rounded. The position of the decimal point relative to 
the beginning of the string is stored indirectly through decpt 
(negative means to the left of the return digits). The decimal 
point is not included in the returned string. If the sign of the 
result is negative, the word pointed to by sign is non-zero- 
otherwise, it is zero. 

fcvt is identical to ecvt, except that the correct digit has been 
rounded for printf "%f" (FORTRAN F-format) output of the 
number of digits specified by ndigit. 

The gcvt function converts the value to a null-terminated 
string in the array pointed to by buf and returns buf It 
attempts to produce ndigit significant digits in FORTRAN 
F-format if possible; otherwise, E-format, ready for printing 
A minus sign, if there is one, or a decimal point will be 
included as part of the returned string. Trailing zeros are 
suppressed. 



Library Functions J 

ecvt 

Known Problems 

The values returned by ecvt and fcvt point to a single static 
data array whose content is overwritten by each call. 

See Also 

printf. 
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Name 

end, etext, edata - last locations in programs 

Format 

extern end ; 
extern etext; 
extern edata; 



Description 

These names refer neither to routines nor to locations with 
interesting contents. The address of etext is the first address 
above the program text, edata above the initialized data 
region, and end above the uninitialized data region. 

When execution begins, the program break (the first location 
beyond the data) coincides with end, but the program break 
may be reset by the routines of brk (see Section 2), malloc 
standard input/output (stdio), the profile (-p) option of cc (see 
Section 1), and so on. Thus, the current value of the program 
break should be determined by sbrk(O) (see brk in Section 2). 

See Also 

brk in Section 2; malloc. 
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Name 

erf, erfc - error function and complementary error function 

Format 

# i nc I ude <ma t h . h> 

double erf ( x ) 
double x ; 

double erfc (x) 
double x ; 

Description 

The erf function returns the error function of x, defined as 




erfc, which returns 1 .0 - erf(x), is provided because of the 
extreme loss of relative accuracy if erf(x) is called for large x 
and the result subtracted from 1 .0 (for example, for x - 5, 12 
places are lost). 

See Also 

exp. 
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Name 

exp, log, Iog10, pow, sqrt - exponential, logarithm, power 
square root functions 

Format 

# i n c I ude <ma 1 h . h> 

doub Is exp ( x) 
doub la x \ 

double log ( x ) 
doub I e x ; 

doub I e I og1 0 ( x) 
doub I e x ; 

double pow ( x , y ) 
doub I e x , y ; 

doub I e 3q r t ( x) 
double x ; 



Description 

exp returns the exponential function (e ). 

log returns the natural logarithm of x. The value of x must be 
positive. * ' 

joglO returns the logarithm base ten of x. The value of x must 
be positive. 

pow returns x y . If x is zero, y must be positive. If x is neqative 
y must be an integer. 

sqrt returns the non-negative square root of x. The value of x 
may not be negative. 
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Diagnostics 

exp returns HUGE when the correct value would overflow, or 
0 when the correct value would underflow, and sets errno to 
ERANGE. 

log and loglO return -HUGE and set errno to EDOM when x is 
non-positive. A message indicating DOMAIN error (or SING 
error when x is 0) is printed on the standard error output. 

pow returns 0 and sets errno to EDOM when x is 0 and y is 
non-positive, or when x is negative and / is not an integer 
In these cases a message indicating DOMAIN error is printed 
on the standard error output. When the correct value for pow 
would overflow or underflow, pow returns +/-HUGE or u, 
respectively, and sets errno to ERANGE. 
sort returns 0 and sets errno to EDOM when x is negative^ A 
message indicating DOMAIN error is printed on the standard 
error output. 

These error handling procedures may be changed with the 
function matherr. 



See Also 

hypot, matherr, sinh. 
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Name 

fclose, fflush - close or flush a stream 

Format 

# i nc I ude <s t d i o . h> 

int fclose { s t ream) 
FILE • s f ream; 

int (flush { s t ream) 
FILE •stream; 

Description 

The fclose function causes any buffered data for the named 
stream to be written out, and the stream to be closed fclose 

exks^em caT t0matiCa '' y ^ a " ° pen fi,es u P° n caliin 9 the 

The fflush function causes any buffered data for the named 
stream to be written to that file. The stream remains open 

Diagnostics 

These functions return 0 for success, and EOF if any error 
SgTiScred"^ " 3 f ' le h3S TOt b6en °^ ed ^ 

See Also 

close, exit in Section 2; fopen, setbuf. 
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Name 

terror, feof. clearerr, fileno - stream status inquiries 

Format 

# i nc I ude <s t d i o . h> 

int terror (sf ream) 
FILE ' s ( ream; 

int feof ( s f ream) 
FILE "St ream; 

void clearerr ( s t ream) 
FILE s t ream; 

Int fileno ( s f ream) 
FILE " s f ream; 

Description 

The terror function returns non-zero when I/O error has 
previously occurred reading from or writing to the named 
stream; otherwise, it returns zero. 

The feof function returns non-zero when EOF has previously 
been detected reading the named input stream; otherwise, it 
returns zero. 

clearerr resets the error indicator and EOF indicator to zero on 
the named stream. 

fileno returns the integer file descriptor associated with the 
named stream; see open in Section 2. 

All of these functions are implemented as macros; they 
cannot be declared or redeclared. 

See Also 

open in Section 2; topers 
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Name 

floor, ceil, fmod, tabs - floor, ceiling, remainder, absolute 
value functions 

Format 

# i n c I ude <ma t h . h> 

doub I e floor ( x) 
doub I e x ; 

doub I e ce i I ( x) 
double x ; 

double fmod (x, y) 
double x , y ; 

double fabs (x) 
double x ; 

Description 

The floor function returns the largest integer (as a 
double-precision number) not greater than x. 

ceil returns the smallest integer not less than x 

fmod returns the floating-point remainder of the division of x 
by y: zero if / is zero or if x/y would overflow; otherwise the 
number f with the same sign as x, such that x = iy + /for 
some integer /', and |/| < \y\. 

fabs returns the absolute value of x, |x| . 

See Also 

abs. 



Library Functions 



3-63 



fopen 

Name 

fopen, f reopen, fdopen - open a stream 

Format 

#lnolude <stdio.h> 

FILE 'fopen {file-name, type) 

char •file-name, 'type; 

FILE 'freopen {file-name. type, stream) 

char 'file-name, 'type; 

F I LE ' st ream; 

FILE "fdopen {tildes, type) 
i n t tildes; 

char type; 

Description 

The fopen function opens the file named by file-name and 
associates a stream with it. fopen returns a pointer to the FILE 
structure associated with the stream. 

File-name points to a character string that contains the name 
of the file to be opened. 

Type is a character string having one of the following values: 



"r" Open for reading. 

"w" Truncate or create for writing. 

" 3 " Append; open for writing at end of file, or create for writing. 

- r+ " Open for update (reading and writing). 

" w + " Truncate or create for update. 

- a+ " Append; open or create for update at end-of-file. 

The freopen function substitutes the named file in place of the 
open stream. The original stream is closed, regardless of 
whether open ultimately succeeds, freopen returns a pointer tc 
the FILE structure associated with stream. 
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The fdopen function associates a stream with a file descriptor 
obtained from open, dup, creat, or pipe system calls, which will 
open files but not return pointers to a FILE structure stream 
which is necessary input for many of the standard I/O library 
functions. The type of stream must agree with the mode of 
the open file. 

When a file is opened for update, both input and output may 
be done on the resulting stream. However, output may not 
be directly followed by input without an intervening fseek or 
rewind, and input may not be directly followed by output 
without an intervening fseek, rewind, or an inpur operation that 
encounters end-of-file. 

When a file is opened for append (that is, when type is "a" or 
a+ ), it is impossible to overwrite information already in the 
tile, fseek may be used to reposition the file pointer to any 
position in the file, but when output is written to the file the 
current file pointer is disregarded. All output is written at the 
end of the file and causes the file pointer to be repositioned 
at the end of the output. If two separate processes open the 
same file for append, each process may write freely to the 
tile without fear of destroying output being written to by the 
other. The output from the two processes will be intermixed 
in the file in the order in which it is written. 

Diagnostics 

fopen and freopen return a NULL pointer on failure. 



See Also 



open in Section 2; fclose. 
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Name 

fread, fwrite - binary input/output 

Format 

^include <stdio.h> 

Int fread [ptr, size, n < t ems , stream) 

char 'ptr; 

Int size, n i terns ; 

FILE • st ream; 

Int twrlte (ptr, size, n i t ems , stream) 

char 'ptr; 

Int size, nit ems ; 

FILE 'st ream; 

Description 

The fread function copies, into an array pointed to by ptr, 
nitems of data from the named input stream, where an item 
of data is a sequence of bytes (not necessarily terminated by 
a null byte) of length size, fread stops appending bytes it an 
end-of-file or error condition is encountered while reading 
stream, or if nitems have been read, fread leaves the file 
pointer in stream, if defined, pointing to the byte following 
the last byte read, if there is one. 

The fwrite function appends at most nitems items of data 
from the array pointed to by ptr to the named output stream 
fwrite stops appending when it has appended nitems items ot 
data or if an error condition is encountered on stream, fwrite 
does not change the contents of the array pointed to by ptr. 

The arqument size is typically sizeofCptr), where the 
pseudo-function sizeof spec.fies the length of an item Pointed 
to by ptr. If ptr points to a data type other than char it should 
be cast into a pointer to char. 
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Diagnostics 

fread and fwrite return the number of items read or written If 
size or nitems is non-positive, no characters are read or 
written and 0 is returned by both fread and fwrite 



See Also 



I, write in Section 2; fopen, getc, gets, printf, putc, puts, scanf . 
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Name 

frexp, Idexp, modf - manipulate parts of floating-point numbers 

Format 

double trexp {value, eptr) 
doub I e value; 
I n t •eptr; 

double Idexp {value, exp) 
double value; 
int exp; 

double modf {value, iptr) 
double value, 'iptr; 



Description 

Every non-zero number can be written uniquely as x * 2" 
where the "mantissa" (fraction) x is in the range 0.5 -< |x| 
< 1 .0, and the "exponent" n is an integer. The frexp function 
returns the mantissa of a double value, and stores the 
exponent indirectly in the location pointed to by eptr. If value 
is zero, both results returned by frexp are zero. 
The Idexp function returns the quantity value ' 2 exp . 
The modf function returns the signed fractional part of value 
and stores the integral part indirectly in the location pointed 
to by iptr. 



Diagnostics 

If Idexp would cause overflow, +/-HUGE is returned 
(according to the sign of value), and errno is set to ERANGE. 

If idexp would cause underflow, zero is returned and errno is 
set to ERANGE. 
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Name 

fseek, rewind, ftell - reposition a file pointer in a stream 

Format 

# i nc I uds <s t d I o . h> 

int fseak ( stream, offset, ptrname) 
FILE •stream: 
i ong offset; 
int pi mams ; 

void rewind (stream) 
F I LE * s I ream, 

I ong ftell ( s f ream) 
FILE * s ( ream; 



Description 

The fseek function sets the position of the next input or 
output operation on the stream. The new position is at the 
signed distance offset bytes from the bginning, from the 
current position, or from the end of the file, according as 
ptrname has the value 0, 1, or 2. 

rew\nd(stream) is equivalent to teeek(stream. 0L, 0), except that 
no value is returned. 

fseek and rewind undo any effects of the ungetc function. 

After fseek or rewind, the next operation on a file opened for 
update may be either input or output. 

The ftell function returns the offset of the current byte 
relative to the beginning of the file associated with the 
named stream. 
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Diagnostics 

fseek returns non-zero for improper seeks; otherwise, zero. 
An improper seek can be, for example, an fseek done on a 
file that has not been opened via fopen; in particular, fseek 
may not be used on a terminal, or on a file opened via popen 

Caution 

On CENTIX, the value returned by fteil is a number of bytes, 
and a program can use this value to seek relative to the 
current offset. Such programs are not portable to systems 
where file offsets are not measured in bytes. 

See Also 

Iseek in Section 2, fopen 
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Name 

ftw - walk a file tree 

Format 

# i n c I ude <ltw.h> 

int ftw (path , fn, depth) 
char 'path; 
int ( • fn) ( ) ; 
i n t depth ; 

Description 

The ftw function recursively descends the directory hierarchy 
rooted in path. For each object in the hierarchy, ftw calls fn, 
passing it a pointer to a null-terminated character string 
containing the name of the object, a pointer to a stat 
structure (see stat in Section 2) containing information about 
the object, and an integer. Possible values of the integer, 
defined in the <ftw.h> header file, are FTW_F for a file, 
FTW_D for a directory, FTW_DNR for a directory that cannot 
be read, and FTW_NS for an object for which stat could not 
successfully be executed. If the integer is FTW_DNR, 
descendants of that directory will not be processed. If the 
integer is FTW_NS, that stat structure will contain garbage. 
An example of an object that would cause FTW_NS to be 
passed to fn would be a file in a directory with read but 
without execute (search) permissions. 

The ftw function visits a directory before visiting any of its 
descendants. 

The tree traversal continues until the tree is exhausted, an 
invocation of fn returns a non-zero value, or some error is 
detected within ftw (such as an I/O error). If the tree is 
exhausted, ftw returns zero. If fn returns a non-zero value, ftw 
stops its tree traversal and returns whatever value was 
returned by fn. If ftw detects an error, it returns -1 , and sets 
the error type in errno. 
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ftw uses one file descriptor for each level in the tree. The 
depth argument limits the number of file descriptors so used. 
If depth is zero or negative, the effect is the same if it were 
1 . Depth must not be greater than the number of file 
descriptors currently available for use. ftw will run more 
quickly if depth is at least as large as the number of levels in 
the tree. 

Known Problems 

Because ftw is recursive, it is possible for it to terminate with 
a memory fault when applied to very deep file structures. 

It could be made to run faster and use less storage on deep 
structures at the cost of considerable complexity. 

ftw uses the malloc function to allocate dynamic storage 
during its operation. If ftw is forcibly terminated, such as by 
longjmp being executed by fn or an attempted routine, ftw will 
not have a chance to free that storage, so it will remain 
permanently allocated. A safe way to handle interrupts is to 
store the fact that an interrupt has occurred, and arrange to 
have fn return a non-zero value at its next invocation. 

See Also 

stat in Section 2; malloc. 



1192192 



3-72 



Library Functions 



gamma 

Name 

gamma - log gamma function 

Format 

# i n c I ude <ma t h . h> 

double gamma ( x ) 
double x ; 

extern i n t si gngam; 

Description 

The gamma function returns ln(| T{x)\), where T (x) is defined as 

oo 

JV« t- l dt. 

0 

The sign of T {*) is returned in the external integer signgam. 
The argument x may not be a non-positive integer. 

The following C program fragment might be used to calculate T : 

if ((y - gamma(x)) > LN_MAXDOUBLE ) 

e r r o r ( ) ; 
y - s i gngam • exp ( y ) ; 

where LN_MAXDOUBLE is the least value that causes the exp 
function to return a range error, and is defined in the 
<values.h> header file. 

Diagnostics 

For non-negative integer arguments, HUGE is returned and 
errno is set to EDOM. A message indicating SIGN error is 
printed on the standard error output. 

If the correct value would overflow, gamma returns HUGE and 
sets errno to ERANGE. 
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These error-handling procedures may be changed with the 
function matherr. 

See Also 

exp, matherr; values in Section 5. 
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Name 

getc, getchar, fgetc, getw - get character or word from a stream 

Format 

# i n c I ude <stdio.h> 

i n t gate (si r earn) 
FILE • s t roam; 

i n t getchar ( ) 

i n t (gate ( s t ream) 
FILE * s t ream; 

i n t getw ( s t ream) 
FILE ' s t ream; 

Description 

The getc function returns the next character (or byte) from the 
named input stream, as an integer. It also moves the file 
pointer, if defined, ahead one character in stream. The getchar 
function is defined as qe\c[stdin). getc and getchar are macros. 

fgetc behaves like getc but is a genuine function, fgetc runs 
more slowly than getc, but it takes less space per invocation 
and its name can be passed as an argument to a function. 

getw returns the next word (integer) from the named input 
stream, getw increments the associated file pointer, if defined, 
to point to the next word. The size of the word is the size of 
an integer and varies from machine to machine, getw 
assumes no special alignment in the file. 

Diagnostics 

These functions return the constant EOF at end-of-file or 
upon an error. Because EOF is a valid integer, the ferror 
function should be used to detect getw errors. 
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Caution 

If the integer value returned by getc, getchar, or fgetc is stored 
into a character variable and then compared against the 
integer constant EOF, the comparison may never succeed, 
because sign-extension of a character on widening to an 
integer is machine-dependent. 

Known Problems 

Because it is implemented as a macro, getc incorrectly treats 
a stream argument with side effects. In particular, getc( f+ + ) 
does not work sensibly, fgetc should be used instead. 
Because of possible differences in word length and byte 
ordering, files written using the putw function are 
machine-dependent, and may not be read using getw on a 
different processor. 



See Also 

fclose, ferror, fopen, fread, gets, putc, scanf. 
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Name 

getcwd - get the path-name of the current working directory 

Format 

char •gatowd (buf, size) 
char "buf: 
i n t size; 

Description 

The getcwd function returns a pointer to the current directory 
path-name. The value of size must be at least two greater 
than the length of the path-name to be returned. 

If buf is a NULL pointer, getcwd will obtain size bytes of space 
using the malloc function. In this case, the pointer returned by 
getcwd may be used as the argument in a subsequent call to free. 

The function is implemented by using popen to pipe the 
output of the pwd shell command into the specified string space. 

Example 

char *cwd , ge t cwd ( ) ; 



if ((cwd - get cwd ( (char* JNULL. 64)) .. NULL) { 
pe r r o r ( " pwd " ) ; 
ex i t ( 1 ) ; 

} 

pr i nt I ( ■%s\n" , cwd) ; 

Diagnostics 

Returns NULL with errno set if size is not large enough, or if 
an error occurs in a lower-level function. 

See Also 

pwd in Section 1 ; malloc, popen. 
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Name 

getenv - return value for environment name 

Format 

char "getenv ( name ) 
char ' name ; 

Description 

The getenv function searches the environment list (see environ 
in Section 5) for a string of the form name -value, and returns 
a pointer to the value in the current environment if such a 
string is present, otherwise a NULL pointer. 

See Also 

exec in Section .2; putenv; environ in Section 5. 
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Name 

getgrent, getgrgid, getgrnam, setgrent, endgrent, fgetgrent - get 

group file entry 

Format 

^include <grp.h> 

struct group 'getgrent () 

struct group "getgrgid (gid) 
i n t gid: 

struct group 'getgrnam (name) 
char "name; 

void setgrent () 

void endg r en t ( ) 

st ruct group ' fgetgrent ( f ) 
FILE * f ; 



Description 

The getgrent, getgrgid, and getgrname functions each return 
pointers to objects with the following structure containing 
the broken-out fields of a line in the /etc/group file. Each line 
contains a "group" structure, defined in the <grp.h> header file 



/• name of the group '/ 
/• encrypted group passwd */ 
/" numerical group ID '/ 
/*. vector of pointers to 
membe r name s * / 

When first called, getgrent returns a pointer to the first group 
structure in the file; thereafter, it returns a pointer to the next 
group structure in the file; so, successive calls may be used 
to search the entire file, getgrgid searches from the beginning 



struct g roup { 

char *gr_name; 

char *gr_passwd; 

ln * gr_gid; 

char **gr_mem; 
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of the file until a numerical group ID matching gid is found 
and returns a pointer to the particular structure in which it 
was found, getgmam searches from the beginning of the file 
until a group name matching name is found a returns a 
pointer to a particular structure in which it was found. If an 
end-of-file or an error is encountered on reading, these 
functions return a NULL pointer. 

A call to setgrent has the effect of rewinding the group file to 
allow repeated searches, endgrent may be called to close the 
group file when processing is complete. 

The fgetgrent function returns a pointer to the next group 
structure in the stream f, which matches the format of 
/etc/group. 

Files 

/etc/group 

Diagnostics 

A NULL pointer is returned on EOF or error. 

Caution 

The above routines use <stdio.h>, which causes them to 
increase the size of programs, not otherwise using standard 
I/O, more than might be expected. 

Known Problems 

All information is contained in a static area, so it must be 
copied if it is to be saved. 

See Also 

getlogin, getpwent; group in Section 4. 



1192192 



3-80 



Library Functions 



getlogin 

Name 

getlogin - get login name 

Format 

char 'get I og i n ( ) ; 

Description 

The getlogin function returns a pointer to the login name as 
found in /etc/utmp. It may be used in conjunction with 
getpwnam to locate the correct password file entry when the 
same user ID is shared by several login names. 

If getlogin is called within a process that is not attached to a 
terminal, it returns a NULL pointer. The correct procedure for 
determining the login name is to call cuserid, or to call getlogin, 
and, if it fails, call getpwuid. 

Files 

/etc/utmp 

Diagnostics 

Returns the NULL pointer if name is not found. 

Known Problems 

The return values point to static data whose content is 
overwritten by each call. 

See Also 

cuserid, getgrent, getpwent; utmp in Section 4. 
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Name 

getopt - get option letter from argument vector 



Format 

int getopt (argc. argv. optstring) 
i n t argc; 

char ''argv, optstring; 

extern char "optarg; 
extern Int optind, opterr; 



Description 

The getopt function returns the next option letter in argv that 
matches a letter in optstring. Opstring is a string of 
recognized option letters. If a letter is followed by a colon, 
the option is expected to have an argument that may or may 
not be separated from it by white space. Optarg is set to 
point to the start of the option argument on return from getopt. 

The getopt function places in optind the argv index of the next 
argument to be processed. Because optind is external, it is 
normally initialized to zero automatically before the first call 
to getopt. 

When all options have been processed (that is, up to the first 
non-option arguments), getopt returns EOF. The special option 
- may be used to delimit the end of the options. EOF will be 
returned and - will be skipped. 



Diagnostics 

getopt prints an error message on the stderr file and returns a 
question mark ('?') when it encounters an option letter not 
included in optstring. This error message may be disabled by 
setting opterr to a non-zero value. 
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Example 

ma In (argc, argv) 
I n t argc; 
char " * a r g v ; 
f 

I n t c ; 

extern char • op t a r g ; 
extern i n t op t i nd ; 



while ({c - getopt(argc, argv, -abf:o:")) I. EOF) 
swi t ch ( c ) ( 
case ' a ' 

If (bf Ig) 

e r r f I g + + ; 

else 

a f I g++ ; 
break ; 
case ' b ' 

If ( a f I g ) 

e r r f I g++ ; 

e I se 

bp roc ( ) ; 

break; 
case ' f ' 

I f I I e - op t a r g ; 

break ; 
case ' o ' 

oflle - optarg; 

break ; 
case ' ? ' 

e r r f I g++ ; 

} 

If (errf Ig) { 

f p r I n t f ( s t de r r , "usage: ■); 
e x I t ( 2 ) ; 

) 

'or ( ; optind < argc; optlnd++) { 
if ( access ( a rgv [ opt i nd ] , 4)) { 



Library Functions 



getopt 



See Also 

getopt in Section 1 
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Name 

getpass - read a password 

Format 

char 'getpass ( p r omp t ) 
char * p r omp t ; 

Description 

The getpass function reads up to a new-line or EOF from the 
file /dev/tty, after prompting the standard error output with 
the null-terminated string prompt and disabling echoing. A 
pointer is returned to a null-terminated string of at most 8 
characters. If /dev/tty cannot be opened, a NULL pointer is 
returned. An interrupt will terminate input and send an 
interrupt signal to the calling program before returning. 

Files 

/dev/tty 

Caution 

The above routine uses <stdio.h>, which causes it to 
increase the size of programs, not otherwise using standard 
I/O, more than might be expected. 

Known Problems 

The return value points to static data whose content is 
overwritten by each call. 

See Also 

crypt. 
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Name 

getpw - get name from UID 

Format 

I n t ge t pw ( u I d , but) 
int uld: 
cha r "but: 

Description 

The getpw function searches the password file for a user id 
number that equals uid. copies the line of the password file 
in which uid was found into the array ponted to by buf, and 
returns 0. getpw returns non-zero if uid cannot be found. 

This routine is included only for compatibility with older 
systems and should not be used; see getpwent for routines to 
use instead. 

Files 

/etc/passwd 

Diagnostics 

getpw returns non-zero on error. 

Caution 

The above routine uses <stdio>, which causes it to increase 
the size of programs, not otherwise using standard I/O, more 
than might be expected. 

See Also 

getpwent; passwd in Section 4. 
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Name 

getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent - 

get password file entry 

Format 



# I nc I ude <pwd . h> 

struct passwd 'getpwent () 

struct passwd 'getpwuid (uid) 
i n t uid; 

struct passwd 'getpwnam (name) 
char 'name; 

void setpwent () 

vo I d endpwen t ( ) 

struct passwd 'fgetpwent (f) 



F I LE ' f ; 



Description 

The getpwent, getpwuid, and getpwnam functions return a pointer 
to an object with the following structure containing the 
broken-out fields of a line in the /etc/passwd file. Each line in 
the file contains a "passwd" structure, declared in the 
<pwd.h> header file: 



struct passwd ( 



char 

char 

int 

int 

char 

char 

cha r 

char 

char 



* pw_name ; 

• pw_pa s swd ; 
pw_u I d ; 
P«_g i d ; 
"P*_age ; 
"pw_commen t ; 
*pw_gecos ; 

* pw_d I r ; 

' pw_she I I ; 



} ; 



This structure is declared in <pwd.h>, so it is not 
to redeclare it. 
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The pw-comment field is unused; the others have meanings 
described in passwd (see Section 4). 

The getpwent function, when first called, returns a pointer to 
the first passwd structure in the file; thereafter, it returns a 
pointer to the next passwd structure in the file; so 
successive calls can be used to search the entire file, getpwuid 
searches from the beginning of the file until a numerical user 
ID matching uid is found, then returns a pointer to the 
particular structure in which it was found, getpwnam searches 
from the beginning of the file until a login name matching 
name is found, then returns a pointer to the particular 
structure in which it was found. If an end-of-file or an error is 
encountered on reading, these functions return a NULL pointer. 

A call to setpwent has the effect of rewinding the password 
file to allow repeated searches, endpwent may be called to 
close the password file when processing is complete. 

The fgetpwent function returns a pointer to the next passwd 
structure in the stream f, which matches the format of 
/etc/passwd. 

Files 

/etc/passwd 

Diagnostics 

A NULL pointer is returned on EOF or error. 

Caution 

The above routines use <stdio.h>, which causes them to 
increase the size of programs, not otherwise using standard 
I/O, more than might be expected. 
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Known Problems 

All information is contained in a static area, so it must be 
copied if it is to be saved. 

See Also 

getlogin, getgrent; passwd in Section 4. 
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Name 

gets, fgets - get a string from a stream 



Format 

# i nc I ude <a td i o . h> 

char "gets (8) 
char ' s ; 

char 'fgets (s, n, stream) 
char ' s ; 
i n t n ; 

FILE * s t r earn; 

Description 

The gets function reads characters from the standard input 
stream, stdin, into the array pointed to by s, until a new-line 
character is read or an end-of-file condition is encountered. 
The new-line character is discarded and the string is 
terminated by a null character. 

The fgets function reads characters from stream into the array 
pointed to by s, until n-1 characters are read, or a new-line 
character is read and transferred to s, or an end-of-file 
condition is encountered. The string is then terminated with a 
NULL character. 



Diagnostics 

If end-of-file is encountered and no characters have been 
read, no characters are transferred to s and a NULL pointer is 
returned. If a read error occurs, such as trying to use these 
functions on a file that has not been opened for reading, a 
NULL pointer is returned. Otherwise, s is returned. 



See Also 

ferror, fopen, fread, getc, scanf. 
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Name 

getutent, getutid, getutline, pututline, setutent, endutent, 
utmpname - access utmp file entry 



Format 

# I nc I uda <u tmp . h> 



struct utmp 'getutent () 

st ruct utmp "getut Id (Id) 
struct u tmp • I d ; 

struct utmp •getuline (line) 
struct u tmp 'line; 

void putut I Ine (utmp) 
struct u tmp * u tmp ; 

void setutent ( ) 

vo I d endutent ( ) 

void u tmpname ( f I I e ) 
char 'file; 
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Description 

The getutent, getutid, and getutline functions return a pointer to 
a structure of the following type: 

struct utmp ( 

char ut_usor[8]; 
char ut_ld[4]; 

char ut_l ine[12] : 

short ut_pld; 
short ut_type; 
struct e x I t _s t a t u s { 

short a_t e rm i na t i on ; 

short e_exlt; 
} ut_exit; 



t ime_t ut_t ime : 

}; 

The getutent function reads in the next entry from a utmp-like 
file. If the file is not already open, getutent opens it. If it 
reaches the end of the file, it fails. 

getutid searches forward from the current point in the utmp 
file until it finds an entry with a ut-type matching id->ut-type 
if the type specified is RUNJ.VL, BOOT_TIME, OLD-TIME, or 
NEW_TIME. If the type specified in id is INIT_PROCESS, 
LOGIN_PROCESS, USER_PROCESS, or DEAD_PROCESS, then 
getutid returns a pointer to the first entry whose type is one 
of these four and whose utJd field matches id->utJd. If the 
end of the file is reached without a match, it fails. 

The getutline function searches forward from the current point 
in the utmp file until it finds an entry of the type 
LOGIN-PROCESS or USER_PROCESS which also has a uUme 
string matching the Hne->utJine string. If the end of the file 
is reached without a match, it fails. 



/•User login name*/ 
/*/etc/inittab id 

(usually line number)*/ 
/'device name (console, 

I nxx) * / 
/ • p r ocess Id*/ 
/ • t ype of entry'/ 

/•Process term, status*/ 
/•Process exit status*/ 
/ -The ex i t status of a 
process marked as 
DEAD_PROCESS* / 
/•time entry was made*/ 



1192192 



3-92 



Library Functions 



getut 

pututline writes out the supplied utmp structure into the utmp 
file. It uses getutid to search forward for the proper place if it 
finds that it is not already at the proper place. It is expected 
that normally the user of pututline will have searched for the 
proper entry using one of the getut routines. If so, pututline will 
not search. If pututline does not find a matching slot for the 
new entry, it will add a new entry to the end of the file. 

setutent resets the input stream to the beginning of the file. 
Do this before each search for a new entry if the entire file 
must be examined. 

endutent closes the currently open file. 

utmpname allows the user to change the name of the file 
examined, from /etc/utmp to any other file. Most often, this 
file will be /etc/utmp. If the file does not exist, this will be 
apparent after the first attempt to reference it, not on the 
utmpname call. This function does not open the file, it just 
closes the old utmp file, if currently open, and saves the new 
file name. 



Files 

/etc/utmp, /etc/wtmp 

Diagnostics 

A NULL pointer is returned upon failure to read, whether due 
to permissions or to having reached the end of the file or 
upon failure to write. 
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Known Problems 

The most current entry is saved in a static structure. Multiple 
accesses require that it be copied before further accesses 
are made. Each call to either getutid or getutline sees the 
routine examine the static structure before performing more 
I/O If the contents of the static structure match what it is 
searching for, it looks no further. For this reason, to use 
getutline to search for multiple occurrences, it is necessary to 
zero out the static after each success, or getutline would just 
return the same pointer over and over again. There is one 
exception to the rule about removing the structure before 
further reads are done. The implicit read done by put . hne Of it 
finds that it is not already at the correct place in the tile) will 
not hurt the contents of the static structure returned by the 
getutent, getutid, or getutline routines, if the user has just 
modified those contents and passed the pointer back to pututhne. 

These routines use buffered standard I/O for input, but 
pututline uses an unbeffered non-standard write to ' ^oid race 
conditions between processes trying to modify the utmp and 
wtmp files. 

See Also 

ttyslot; utmp in Section 4. 
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Name 

hsearch, hcreate, hdestroy - manage hash search tables 

Format 

#1 nc I ude <search . h> 

ENTRY 'hsearch (item, action) 
ENTRY Item; 
ACTION act Ion; 

I n t hcreate ( ne I ) 
una I gned ne I ; 

void hdestroy () 

Description 

The hsearch function is a hash-table search routine generalized 

from Knuth (6.4) Algorithm D. It returns a pointer to a hash 

table indicating the location at which an entry can be found 

Item is a structure of type ENTRY (defined in the <search.h> 

header file) containing two pointers: item.key points to the 

comparison key, and item.data points to any other data 

associated with that key. (Pointers to types other than 

character should be cast to type pointer-to-character.) Action 

is a member of an enumeration type ACTION indicating the 

disposition of the entry, if it cannot be found in the table 

ENTER indicates that the item should be inserted in the table 

at the appropriate point. FIND indicates that no entry should 

? .f ; Unsucces sful resolution is indicated by the return 
of a NULL pointer. 

The hcreate function allocates sufficient space for the table 
and must be called before hsearch is used. /Ve/is an estimate 
of the maximum number of entries that the table will contain 
This number may be adjusted upward by the algorithm in 
order to obtain certain mathematically favorable 
circumstances. 
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The hdestroy function destroys the search table, freeing the 
memory used by the table. It may be followed by another 
call to hcreate. 

hsearch uses "open addressing" with a "multiplicative" hash 
function. However, its source code has many other options 
available which the user may select by compiling the hsearch 
source with the following symbols defined to the 
preprocessor: 

DIV Use remainder modulo table size as the hash function 

instead of the multiplicative algorithm. 

Use a User Supplied Comparison Routine for ascertaining 
table membership. The routine should be named hcompar 
and should behave in a manner similar to strcmp (see string). 

Use a linked list to resolve collisions. If this option is 
selected, the following options become available. 

START Place new entries at the beginning of 

the linked list (default is at the end). 

SORTUP Keep the linked list sorted by key in 

ascending order. 

SORTDOWN Keep the linked list sorted by key in 
descending order. 

Additionally, there are preprocessor flags for obtaining 
debugging printout (-DDEBUG) and for including a test driver in 
the calling routine (-DDRIVER). The source code should be 
consulted for further details. 



USCR 



CHAINED 



Example 

The following example will read in strings followed by two 
numbers and store them in a hash table, discarding the 
duplicates. It will then read in strings and find the matching 
entry in the hash table, then print it out. 
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^include <s t d I o . h> 
* i nc I ude <sea r ch . h> 



struct Info ( /'thio i. .h» i . 

' ' ,nls •» the info stored in table' 

j lnt a 9«- r °om; /'other than the key.-/ 

#def,ne NUM_EMPL 5000 /•# of elements in search table'/ 



ma i n ( ) 
{ 



/'space to store strings*/ 

char strlng_space[NUM_EMPL'20J ; 

/'space to store employee Info'/ 

struct info I n f o_space [NUM_EMPL] • 

/'next available space in s t r i ng_spa ce ' / 

char 'str_ptr - s t r I ng_space ; 

/'next available space In lnfo_space'/ 

struct info 'lnfo_ptr - info_space; 

ENTRY item. • f ound_l tern, 'hsearch<); 

/'name to look for In table'/ 

char name_to_f lndf.30] ; 

I n t I . o ; 



/'create table'/ 

(void) hcreate(NUM_EMPL) ; 

while (scant C%s%d%d'. str_ptr, 4 1 n f o_p t r - >a ge 

Slnfo_ptr->room) I- EOF S4 i ++ < NUM_EMPL) { 
/put info in structure, and structure In Item'/ 
i tern. key . str_ptr; ' 
I tern. data . (char • ) I nf o_pt r ; 
str_ptr +- strlen(str_ptr) + 1; 
lnfo_ptr++; 

/"put I t em Into table*/ 
^ (void) hsearch(i tern, ENTER); 

/ 'access table* / 
I t em .key - name_to_f i nd ; 
while <scanf<-%»-, Item. key) !- EOF) { 

If ((found_item . hsearch( i tern, FIND)) I- NULL ) f 
/ if Item Is in the table*/ 
(void)printf ('found %s , age - %d , 

room - %d\n', f ound_i tem->key , 
((struct Info *)found_ltem->data)->age 
} else { (<S,rUCt ln '° •> f ° un °-i tem->data)->room) ; 

( vold)pr in t f ( 'no such employee %s\n", 
name_to_f i nd ) 

} 
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Diagnostics 

hsearch returns a NULL pointer if either the action is FIND and 
the item could not be found, or the action is ENTER and the 
table is full. 

hcreate returns zero if it cannot allocate sufficient space for 
the table. 

Caution 

hsearch and hcreate use the malloc function to allocate space. 

Known Problems 

Only one hash search table may be active at any given time. 



See Also 

hsearch, Isearch, malloc, string, tsearch. 



1192192 



3-98 

Library Functions 



hypot 

Name 

hypot - Euclidean distance function 

Format 

* i no I ude <ma t h . h> 

doub I e h ypo t ( x , y ) 
double x , y ; 

Description 

The hypot function returns 

sqrt(x • x + y * y), 
taking precautions against unwarranted overflows. 

Diagnostics 

When the correct value would overflow, hypot returns HUGE 
and sets errno to ERANGE. 

These error-handling procedures may be changed with the 
matnerr function. 



See Also 

matherr, exp. 
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Name 

l3tol, ltol3 - convert between 3-byte integers and long 
integers 



Format 

void I 3 1 o I (/p, cp, n) 
long ' lp; 
char 'cp; 
I nt n; 



void 1 1 o I 3 (cp, /p. n) 
char *cp; 
long 'lp; 
I nt n; 



Description 

The l3tol function converts a list of n three-byte integers 
packed into a character string pointed to by cp into a list of 
long integers pointed to by lp. 

The ltol3 function performs the reverse conversion from long 
integers (lp) to three-byte integers (cp). 
These functions are useful for file-system maintenance where 
the block numbers are three bytes long. 



Known Problems 

Because of possible differences in byte ordering, the 
numerical values of the long integers are machine-dependent. 



See Also 

fs in Section 4. 
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Name 

Idahread - read the archive header of a member of an 
archive file 



Format 

#1 nc I uda <s t d I o . h> 
# i nc I ude <a r . h> 
#i nc I ude <l i | ehdr . h> 
#1 nc I ude <l d f cn . h> 

Int Idahread {ldptr, arhead) 
LDF I LE * Idptr; 
ARCHDH 'arhead; 

Description 

If TVPE{fdptr) is the archive file magic number, the Idahread 
function reads the archive header of the common object file 
currently associated with Idptr into the area of memory 
beginning at arhead. 1 

Idahread returns SUCCESS or FAILURE. The function will fail if 
TYPtifdptr) does not represent an archive file, or if it cannot 
read the archive header. 

The program must be loaded with the object file access 
routine library libld.a. 



Files 

/usr/lib/libld.a 



See Also 



Idclosa, Idopen; Idfcn, ar in Section 4. 
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Name 

Idclose. Idaclose - close a common object file 



Format 

#i nc I ude <s td I o . h> 
#1 nc I ude <t I I ehdr . h> 
#lnclude <ldfcn.h> 

int Idclose {Idptr) 
LDFILE • Idptr; 

int Idaclose ( Idptr) 
LDF I LE 'Idptr; 



Description 

The Idopen and Idclose functions are designed to provide 
uniform access to both simple object files and object files 
that are members of archive files. Thus an archive of 
common object files can be processed as if it were a series 
of simple common object files. 

If JYPE(ldptr) does not represent an archive file, Idclose will 
close the file and free the memory allocated to the LDFILE 
structure associated with Idptr. If TYPEVdptr) is the magic 
number of an archive file, and if there are any more files in 
the archive, Idclose will reinitialize OFFSET (idptr) to the file 
address of the next archive member and return FAILURE. The 
LDFILE structure is prepared for a subsequent Idopen. In all 
other cases, Idclose returns SUCCESS. 

Idaclose closes the file and frees the memory allocated to the 
LDFILE structure associated with Idptr regardless of the value 
of JYPE(ldptr). Idaclose always returns SUCCESS. The function 
is often used in conjunction with Idaopen. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

fclose, Idopen; idfcn in Section 4. 
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Name 

Idfhread - read the file header of a common object file 

Format 

#i nc I ude <s t d I o . h> 
#1 nc I ude <f I I ehd r . h> 
#1 nc I ude <l d 1 cn . h> 

int Idfhread {Idptr, tllehead) 
LDFILE * Idptr; 
FILHDH * f I lehead; 

Description 

The Idfhread function reads the file header of the common 
object file currently associated with Idptr into the area of 
memory beginning at filehead. 

Idfhread returns SUCCESS or FAILURE. The function will fail if 
it cannot read the file header. 

In most cases, the use of Idfhread can be avoided by using 
the macro HEADER{ldptr). defined in Idfcn.h (see Idfcn in 
Section 4). The information in any field, fieldname, of the file 
header may be accessed using HE ADER(/dptr). fieldname. 

The program must be loaded with the object file access 
routine library libld.a. 

Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen; Idfcn in Section 4. 
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Name 

Idgetname - retrieve symbol name for common object file 
symbol table entry 

Format 

#1 nc I tide <s td I o . h> 

#1 nc I ude <f I I ehdr . h> 

#lnclude <syms.h> 

# I nc I ude < I d f cn . h> 

char 'Idgetname (Idptr, symbol) 
LDFILE • Idptr; 
SYMENT 'symbol; 

Description 

The Idgetname function returns a pointer to the name 
associated with symbol as a string. The string is contained in 
a static buffer local to Idgetname that is overwritten by each 
call to Idgetname, and therefore must be copied by the caller if 
the name is to be saved. 

As of UNIX System release 5.0, which corresponds with the 
first release of CENTIX, the common object file format has 
been extended to handle arbitrary length symbol names with 
the addition of a "string table." Idgetname will return the 
symbol name associated with a symbol table entry for either 
a pre-UNIX System 5.0 object file or a UNIX System 5.0 
object file. Thus, Idgetname can be used to retrieve names 
from object files without any backward compatibility 
problems. Idgetname will return NULL (defined in stdio.h) for a 
UNIX System 5.0 object file if the name cannot be retrieved 
This situation can occur: 

□ if the "string table" cannot be found, 

a if not enough memory can be allocated for the string table. 
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□ if the string table appears not to be a string table (for 
example, if an auxiliary entry is handed to Idgetname that 
looks like a reference to a name in a non-existent string 
table, or 

□ if the name's offset into the string table is past the end of 
the string table. 

Typically, Idgetname will be called immediately after a 
successful call to Idtbread to retrieve the name associated 
with the symbol table entry filled by Idtbread. 

The program must be loaded with the object file access 
routine library libld.a. 

Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idtbread, Idtbseek; Idfcn in Section 4. 
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Name 

Idlread, Idlinit, Idlitem - manipulate line number entries of a 
common object file function 

Format 

#i nc I ude <s t d I o . h> 
#i no I ude <f l l ehd r . h> 
#lncluda <llnsnum.h> 
# I no I ude < I d t on . h> 

int Idlread (Idptr, fcnlndx, llnenum. linent) 

LDFILE 'Idptr; 

long fcnlndx; 

unsigned short llnenum; 

LINENO linent; 

Int Idlinlt (Idptr, fcnlndx) 
LDFI LE * Idptr; 
long fcnlndx; 

Int Idlitem (Idptr, llnenum. linent) 
LDFI LE 'Idptr; 
unsigned short llnenum; 
LINENO linent; 



Description 

The Idlread function searches the line number entries of the 
common object file currently associated with Idptr. Idlread 
begins its search with the line number entry for the beginning 
of a function and confines its search to the line numbers 
associated with a single function. The function is identified 
by fcnmdx, the index of its entry in the object fiie symbol 
table. Idlread reads the entry with the smallest line number 
equal to or greater than linenum into linent. 
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Idlinit and Idlitem together perform exactly the same function 
as Idlread. After an initial call to Idlread or Idlinit, Idlitem may be 
used to retrieve a series of line number entries associated 
with a single function. Idlinit simply locates the line number 
entries for the function identified by fcnindx. Idlitem finds and 
reads the entry with the smallest line number equal to or 
greater than linenum to linent. 

Idlread, Idlinit, and Idlitem each return either SUCCESS or 
FAILURE. Idlread will fail if there are no line number entries in 
the object file, if fcnindx does not index a function entry in 
the symbol table, or if it finds no line number equal to or 
greater than linenum. Idlinit will fail if there are no line number 
entries in the object file or if fcnindx does not index a 
function entry in the symbol table. Idlitem will fail if it finds no 
line number equal to or greater than linenum. 

The programs must be loaded with the object file access 
routine library libld.a. 

Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idtbindex; Idfcn in Section 4. 
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Name 

Idlseek, Idnlseek - seek to line number entries of a section 
of a common object file 

Format 

# I nc I ude <s t d i o . h> 
#1 nc I ude <f I I ehd r . h> 
* i nc I ude < I d f on . h> 

Int Idlseek (Idptr, sectlndx) 

LDFILE 'Idptr, 

unsigned short sectlndx; 

Int Idnlseek (idptr, sectname) 
LDFILE 'Idptr; 
char • sec tname; 

Description 

The Idlseek function seeks to the line number entries of the 
section specified by sectindx of the common object file 
currently associated with Idptr. 

Idnlseek seeks to the line number entries of the section 
specified by sectname. 

Idlseek and Idnlseek return SUCCESS or FAILURE. Idlseek will fail 
if sectindx is greater than the number of sections in the 
object file; Idnlseek will fail if there is no section name 
corresponding with "sectname. Either function will fail if the 
specified section has no line number entries or if it cannot 
seek to the specified line number entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idshread; Idfcn in Section 4. 
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Name 

Idohseek - seek to the optional file header of a common 
object file 

Format 

# i nc I ude <s t d I o . h> 
#1 no I ude <f i l ehdr . h> 
* i nc I ude < I d f cn . h> 

int Idohseek ( Idptr) 
LDF I LE 'Idptr; 

Description 

The Idohseek function seeks to the optional file header of the 
common object file currently associated with Idptr. 

Idohseek returns SUCCESS or FAILURE. It will fail if the object 
file has no optional header or if it cannot seek to the optional 
header. 

The program must be loaded with the object file access 
routine library libld.a. 

Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idfhread; Idfcn in Section 4. 
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Name 

Idopen, Idaopen - open a common object file for reading 

Format 

# I nc I ude <s t d I o . h> 
#1 nc I ude <f i I ehdr . h> 
# I nc I ude < I d ( cn . h> 

LDFILE "Idopen (filename, Idptr) 
char 'II I a name ; 
LDFILE * Idptr; 

LDFILE 'Idaopen {filename, oldptr) 
char • / / / ename ; 
LDFILE 'oldptr; 



Description 

The Idopen and Idclose functions are designed to provide 
uniform access to both simple object files and object files 
that are members of archive files. Thus, an archive of 
common object files can be processed as if it were a series 
of simple common object files. 

If Idptr has the value NULL, then Idopen will open filename and 
allocate and initialize the LDFILE structure, and return a 
pointer to the structure to the calling program. 

If Idptr is valid and if TVPE{ldptr) is the archive magic number, 
Idopen will reinitialize the LDFILE structure for the next archive 
member of filename. 

Idopen and Idclose are designed to work together. Idclose will 
return FAILURE only when TVPE(/dptr) is the archive magic 
number and there is another file in the archive to be 
processed. Only then should Idopen be called with the current 
value of idptr. In all other cases, in particular whenever a new 
filename is opened, Idopen should be called with a NULL Idptr 
argument. 
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The following is a prototype for the use of Idopen and Idclose. 

/•for each filename to be processed*/ 

Idptr - NULL; 
do 

f 

If ((Idptr - I dopen ( f I I ename , Idptr)) !- NULL) 

/'check magic number - / 
/ 'process the file*/ 

) 

) while ( ldclose( Idptr) FAILURE); 

If the value of oldptr is not NULL, Idaopen will open a new 
filename and allocate and initialize a new LDFILE structure 
copying the TYPE, OFFSET, and HEADER fields from oldptr. 
Idaopen returns a pointer to the new LDFILE structure. This 
new pointer is independent of the old pointer, oldptr. The 
two pointers may be used concurrently to read separate 
parts of the object file. For example, one pointer may be 
used to step sequentially through the relocation information, 
while the other is used to read indexed symbol table entries. 

Both Idopen and Idaopen open filename for reading. Both 
functions return NULL if filename cannot be opened, or if 
memory for the LDFILE structure cannot be allocated. A 
successful open does not insure that the given file is a 
common object file or an archived object file. 

The program must be loaded with the object file access 
routine library libld. a. 

Files 

/usr/lib/libld.a 

See Also 

fopen, Idclose; Idfcn in Section 4. 



Library Functions 



3-113 



Idrseek 

Name 

Idrseek, Idnrseek - seek to relocation entries of a section of 
a common object file 

Format 

# I nc I ude <s t d i o . h> 
#include <fllehdr.h> 
# i nc I ude <ld(cn.h> 

int Idrseek {Idptr, sectindx) 

LDFILE 'Idptr; 

unsigned short sectindx; 

int Idnrseek {Idptr, seotname) 
LDFILE 'Idptr; 
char 'see (name; 

Description 

The Idrseek function seeks to the relocation entries of the 
section specified by sectindx of the common object file 
currently associated with Idptr. 

Idnrseek seeks to the relocation entries of the section 
specified by sectname. 

Idrseek and Idnrseek return SUCCESS or FAILURE. Idrseek will 
fail if sectindx is greater than the number of sections in the 
object file; Idnrseek will fail if there is no section name 
corresponding with sectname. Either function will fail if the 
specified section has no relocation entries or if it cannot seek 
to the specific relocation entries. 

Note that the first section has an index of one. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idshread; Idfcn in Section 4. 
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Name 

Idshread, Idnshread - read an indexed/named section header 
of a common object file 

Format 

# I nc I ude <s t d I o . h> 
# i nc I ude <f I I ehdr . h> 

# i no I ude <scnhd r . h> 

# i nc I ude <l d f en . h> 

Int Idshread {Idptr, sectindx, secthead) 

LDFILE ' Idptr; 

unsigned short sectindx: 

SCNHDR 'secthead; 

int Idnshread (Idptr, sectname. secthead) 
LDFILE * Idptr; 
char 'sectname; 
SCNHDR 'secthead; 



Description 

The Idshread function reads the section header specified by 
sectindx of the common object file currently associated with 
Idptr into the area of memory beginning at secthead. 

Idnshread reads the section header specified by sectname into 
the area of memory beginning at secthead. 

Idshread and Idnshread return SUCCESS or FAILURE. Idshread will 
fail if sectindx is greater than the number of sections in the 
object file; Idnshread will fail if there is no section name 
corresponding with sectname. Either function will fail if it 
cannot read the specified section header. 

Note that the first section header has an index of one. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen; Idfcn in Section 4. 
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Name 

Idsseek, Idnsseek - seek to an indexed/named section of a 
common object file 

Format 

0 i nc I ude <s t d i o . h> 
#1 nc I ude <( I I ehdr . h> 
# I nc I ude <l dl cn . h> 

int Idsseek (Idptr, sectindx) 

LDFILE * Idptr; 

unsigned short sectindx; 

int Idnsseek (Idptr. sactname) 
LDFILE • Idptr; 
char 'sectname: 

Description 

The Idsseek function seeks to the section specified by sectindx 
of the common object file currently associated with Idptr. 

The Idnsseek function seeks to the section specified by sectname. 

Idsseek and Idnsseek return SUCCESS or FAILURE. Idsseek will 
fail if sectindx is greater than the number of sections in the 
object file; Idnsseek will fail if there is no section name 
corresponding with sectname. Either function will fail if there 
is no section data for the specified section or if it cannot 
seek to the specified section. 

Note that the first section has an index of one. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idshread; Idfcn in Section 4. 
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Name 

Idtbindex - compute the index of a symbol table entry of a 
common object file 

Format 

# i nc I udo <s t d i o . h> 
#i nc I ude <f i I ehdr . h> 
#1 nc I ude <syms . h> 

# i n c I ude < I d f cn . h> 

I ong Idtbindex ( Idptr) 
LDF I LE •Idptr: 

Description 

The Idtbindex function returns the (long) index of the symbol 
table entry at the current position of the common object file 
associated with Idptr. 

The index returned by Idtbindex may be used in subsequent 
calls to the Idtbread function. However, since Idtbindex returns 
the index of the symbol table entry that begins at the current 
position of the object file, if Idtbindex is called immediately 
after a pellicular symbol table entry has been read, it will 
return the index of the next entry. 

Idtbindex will fail if there are no symbols in the object file, or if 
the object file is not positioned at the beginning of a symbol 
table entry. 

Note that the first symbol in the symbol table has an index of 
zero. 

The program must be loaded with the object file access 
routine library libld.a. 
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Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idtbread, Idtbseek, Idfcn in Section 4. 
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Name 

Idtbread - read an indexed symbol table entry of a 
common object file 

Format 

# i nc I ude <s t d I o . h> 

# I n c l ude <f I I ehdr . h> 
#include <syms.h> 

# i n c I uds < I d t cn . h> 

int Idtbread {Idptr, symindex, symbol) 
LDFI LE * Idptr; 
long symindex; 
SYMENT •symbol; 

Description 

The Idtbread function reads the symbol table entry specified 
by symindex of the common object file currently associated 
with Idptr into the area of memory beginning at symbol. 

Idtbread returns SUCCESS or FAILURE. It will fail if symindex is 
greater than the number of symbols in the object file, or if it 
cannot read the specified symbol table entry. 

Note that the first symbol in the symbol table has an index of 
zero. 

The program must be loaded with the object file access 
routine library libld.a. 

Files 

/usr/lib/libld.a 

See Also 

Idclose, Idopen, Idtbseek; Idfcn in Section 4. 
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Name 

Idtbseek - seek to the symbol table of a common object file 

Format 

# I nc I tide o t d I o . h> 
#1 nc I ude <f i I ehdr . h> 
#i nc I ude <l d f cn . h> 

I n t Idtbseek ( I apt r) 
LDFILE 'Idptr; 



Description 

The Idtbseek function seeks to the symbol table of the object 
file currently associated with Idptr. 

Idtbseek returns SUCCESS or FAILURE. It will fail if the symbol 
table has been stripped from the object file, or if it cannot 
seek to the symbol table. 

The program must be loaded with the object file access 
routine library libld.a. 



Files 

/usr/lib/libld.a 



See Also 



Idclose, Idopen, Idtbread; Idfcn in Section 4. 
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Name 

lockf - record locking on files 



Format 

# I nc I ude <un I s t d . h> 



lockf (tildes, function, size) 
long size: 

Int tildes, function; 



Description 

The lockf function will allow sections of a file to be locked 
(advisory write locks). (Mandatory or enforcement mode 
record locks are not currently available.) Locking calls from 
other processes that attempt to lock the locked file section 
will either return an error value or be put to sleep until the 
resource becomes unlocked. All the locks for a process are 
removed when a process terminates. (See fcntl in Section 2 
for more information about record locking.) 

Fildes is an open file descriptor. The file descriptor must have 
CLWRONLY or CLRDWR permission on order to establish 
lock with this function call. 

Function is a control value that specifies the action to be 
taken. The permissible values for function are defined in 
<unistd.h> as follows: 

#def I ne F_ULOCK 0 

/•Unlock a previously locked section - / 

#def i ne F_LOCK 1 

/•Lock a section for exclusive use*/ 

#define F_TLOCK 2 

/•Test and lock a section lor exclusive use*/ 

#de f i ne F_TEST 3 

/•Test section for other processes' locks*/ 

All other values of function are reserved for future extensions 
and will result in an error return if not implemented. 
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F_TEST is used to detect if a lock by another process is 
present on the specified section. F_LOCK and F_TLOCK both 
lock a section of a file if the section is available. F.UNLOCK 
removes locks from a section of the file. 

Size is the number of contiguous bytes to be locked or 
unlocked. The resource to be locked starts at the current 
offset in the file and extends forward for a positive size and 
backward for a negative size. If size is zero, the section from 
the current offset through the largest file offset is locked 
(that is, from the current offset through the present or any 
future end-of-file). An area need not be allocated to the file in 
order to be locked, as such locks may exist past the end-of-file. 

The sections locked with FJ.OCK or F.TLOCK may, in whole 
or in part, contain or be contained by a previously locked 
section for the same process. When this occurs, or if 
adjacent sections occur, the sections are combined into a 
single section. If the request requires that a new element be 
added to the table of active locks and this table is already 
full, an error is returned, and the new section is not locked. 

F_LOCK and F_TLOCK requests differ only by the action 
taken if the resource is not available. FJLOCK will cause the 
calling process to sleep until the resource is available. 
F_.TL.OCK will cause the function to return a -1 and set errno 
to [EACCESS] error if the section is already locked by 
another process. 

F.ULOCK requests may, in whole or in part, release one or 
more locked sections controlled by the process. When 
sections are not fully released, the remaining sections are still 
locked by the process. Releasing the center section of a 
locked section requires an additional element in the table of 
active locks. If this table is full, an [EDEADLK] error is 
returned and the requested section is not released. 

A potential for deadlock occurs if a process controlling a 
locked resource is put to sleep by accessing another 
process's locked resource. Thus, calls to lock or fcntl scan for 
a deadlock prior to sleeping on a locked resource. An error 
return is made if sleeping on the locked resource would 
cause a deadlock. 
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Sleeping on a resource is interrupted with any signal The 
alarm system call may be used to provide a timeout facility in 
applications that require this facility. 
The lockf utility fails if one or more of the following are true: 



[EBADF] 
[EACCESS] 

[EDEADLK] 
[ENQLCK] 



Fildes is not a valid open descriptor. 

C/nrfis F_TL0CK or F_TEST and the section is already locked by 

another process. 

Cmd \s FJ.0CK or F_TL0CK and a deadlock would occur. 

The and is F_L0CK, F_TL0CK, or FJJLOCK and the number of 
entries in the lock table would exceed the number allocated on the 
system. (Note that this differs from EDEADLOCK.) 



Returns 

Upon successful completion, a value of 0 is returned. 
Otherwise, a value of -1 is returned and errno is set tc 
indicate the error. 



Cautions 

Unexpected results may occur in processes that do buffering 
in the user address space. The process may later read/write 
data that is or was locked. The standard I/O package is the 
most common source of unexpected buffering. 

See Also 

close, creat, fcntl, intra, open, read, write in Section 2. 
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Name 

logname - return login name of user 

Format 

char ' l ogname ( ) 

Description 

The logname function returns a pointer to the null-terminated 
login name; it extracts the $LOGNAME variable from the 
user s environment. 

This routine is kept in /lib/libPW.a. 

Files 

/etc/profile 

Known Problems 

The return values point to static data whose content is 
overwritten by each call. 

This method of determining a login name is subject to forgery. 

See Also 

env, login in Section 1 ; profile in Section 4; environ in 
Section 5. 
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Name 

Isearch, Ifind - linear search and update 



Format 

#1 nc I ude <s t d i o . h> 
#i nc I ude <search . h> 



char -Isearch ((char ')key. (char 

s Izeofi ' key ) . compar) 
unsigned 'nelp; 
Int {' eompar) {) ; 



) base , nelp. 



char * I f I nd ( (char 

compa r ) 
unsigned 'nelp; 
Int C compar) (); 



)key. (char ')base, nelp. s izeot( ' key ) 



Description 

The Isearch function is a linear search routine generalized from 
Knuth (6.1) Algorithm S. It returns a pointer to a table 
indicating where a datum can be found. If the datum is not 
found, it is added to the end of the table. Key points to the 
datum to be sought in the table. Base points to the first 
element in the table. Nelp points to an integer containing the 
current number of elements in the table. The integer is 
incremented if the datum is added to the table. Compar is the 
name if the comparison function that the user must supply 
(strcmp, for example). It is called with two arguments that 
point to the elements being compared. The function must 
return zero if the elements are equal; non-zero, otherwise. 

Ifind is the same as Isearch except that if the datum is not 
found, it is not added to the table. Instead, a NULL pointer is 
returned. 

The pointers to the key and the element at the base of the 
table should be of type pointer-to-element, and cast to type 
pointer-to-character. 
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The comparison function need not compare every byte so 
arbitrary data may be contained in the elements in addition to 
the values being compared. 

Although declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 

Example 

This fragment will read =< TABSIZE strings of length =< 
ELSIZE and store them in a table, eliminating duplicates. 

# i nc I ude <s ! d i o . h> 
#includa <search.h> 

#def i ne TABSIZE 50 
#define ELSIZE 120 

char I InefELSIZE] . t ab [ TABS IZE] [ELSIZE], 'Isearch 
una I gned ne I • 0 ; 
I n t s t r cmp ( ) ; 

while (fgetsfllne. ELSIZE, stdin) I- NULL && 
net < TABSIZE) 

(void) Isearchf I ine, (char •)tab, &nel, 
ELSIZE. strcmp); 



Diagnostics 

If the searched for datum is found, both Isearch and Ifind 
return a pointer to it. Otherwise, Ifind returns NULL and Isearch 
returns a pointer to the newly added element. 

Known Problems 

Undefined results can occur if there is not enough room in 
the table to add a new item. 



See Also 

bsearch, hsearch, tsearch. 
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Name 

malloc, free, realloc, calloc, mallopt, mallinfo - fast main 
memory allocator 

Format 

#1 nc I ude <ma I I oc . h> 

char "ma I I oc (s tze) 
unsigned size; 

void tree (ptr) 
char 'ptr; 

char 'real loc (pic size) 
char 'ptr; 
unsigned size; 

char 'calloc (nelem. elslze) 
unsigned nelem, elslze; 

Int mal lopt (cmd, value) 
int cmd, value; 

struct ma I I I n f o (max) 
Int max; 



Description 

The malloc and free functions provide a simple 
qeneral-purpose memory allocation package, which runs 
considerably faster than the slower malloc package It is found 
in the library -malloc," and is loaded if the option -Imalloc is 
used with cc or Id (see Section 1). 
malloc returns a pointer to a block of at least size bytes 
suitably aligned for any use. 

The argument to free is a pointer to a block previously 
allocated by malloc; after free is performed, this space is made 
available for further allocation, and its contents are destroyed 
(see mallopt, below, for a way to change this behavior). 
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Undefined results will occur if the space assigned by malloc is 
overrun, or if some random number is handed to free. 

The realloc function changes the size of the block pointed to 
by ptr to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the 
lesser of the new and old sizes. 

calloc allocates space for an array of nelem elements of size 
elsize. The space is initialized to zeros. 

mallopt provides for control over the allocation algorithm The 
available values for cmd are: 

NLMXFAST Set maxfast to value. The algorithm allocates all blocks 

below the size of maxfast in large groups and then doles 
them out very quickly. The default value for maxfast is 0. 

Set numlblks to value. The above mentioned large groups 
each contain numlblks blocks. Numlblks must be greater 
than 0. The default value for numlblks is 100. 

Set grain to value. The sizes of all blocks smaller than 
maxfast are considered to be rounded to the nearest 
multiple of grain. Grain must be greater than 0. The default 
value of grain is the smallest number of bytes that will 
allow alignment of any data type. Value will be rounded up 
to a multiple of the default when grain is set. 

Preserve data in a freed block until the next malloc, 
realloc, or calloc. This option is provided only for 
compatibility with the old version of malloc and is not 
recommended. 

These values are defined in the <mailoc.h> header file. 

mallopt may be called repeatedly, but may not be called after 
the first small block is allocated. 



WLNLBLKS 



MJ3RAIN 



NLKEEP 
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mailinfo provides instrumentation describing space usage. It 
returns the structure: 



} 

This structure is defined in the <malloc.h> header file. 

Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for storage 
of any type of object. 

Diagnostics 

malloc, realloc, and calloc return a NULL pointer if there is not 
enough available memory. When realloc returns NULL, the 
block pointed to by ptr is left intact. If mallopt is called after 
any allocation or if cmd or value are invalid, non-zero is 
returned. Otherwise, it returns zero. 

Cautions 

This package usually uses more data space than the slower 
version of malloc. 

The code size is also bigger than the slower malloc. 

Note that unlike the slower version of malloc, this package 
does not preserve the contents of a block when it is freed, 
unless the M_KEEP option of mallopt is used. 

Undocumented features of the slower malloc have not been 
duplicated. 



struct mailinfo { 
I n t arena; 



/•total space in arena*/ 
/•number of ordinary blocks'/ 
/•number ot small blocks*/ 
/•space In holding block headers*/ 
/•number of holding blocks'/ 
/'space In small blocks in use'/ 
/'space in free small blocks'/ 
/'space In ordinary blocks In use'/ 
/'space in free ordinary blocks*/ 
/•space In penalty if keep option*/ 
/•Is used*/ 



I n t o r db I ks ; 

i n t smb Iks; 

int hblkhd; 

I n t hb I ks ; 



Int usmblks: 

int f smb Iks; 

Int uordblks; 

int f or db I ks ; 

I n t keepcos t ; 



nq?i<)2 



* Library Functions 

malloc (fast version) 

See Also 

brk in Section 2; malloc 
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Name 

malloc, free, realloc, calloc - main memory allocator 

Format 

cha r 'ma I I oc { s Ize) 
unsigned size: 

void free (ptr) 
char 'ptr; 

char 'realloc (ptr. size) 
char 'ptr; 
unsigned size; 

char 'calloc {nelem, elslze) 
unsigned nelem, elslze; 



Description 

The malloc and free functions provide a simple 
general-purpose memory allocation package, malloc returns a 
pointer to a block of at least size bytes suitably aligned for 
any use. 

The argument to free is a pointer to a block previously 
allocated by malloc; after free is performed, this space is made 
available for further allocation, but its contents are left 
undisturbed. 

Undefined results will occur if the space assigned by malloc is 
overrun or if some random number is handed to free. 

malloc allocates the first big enough contiguous reach of free 
space found in a circular search from the last block allocated 
or freed, coalescing adjacent free blocks as it searches. It 
calls sbrk (see Section 2) to get more memory from the 
system when there is no suitable space already free. 
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realloc changes the size of the block pointed to by ptr to size 
bytes and returns a pointer to the (possibly moved) block 
The contents will be unchanged up to the lesser of the new 
and old sizes. If no free block of size bytes is available in the 
storage arena, then realloc will ask malloc to enlarge the arena 
by size bytes and will then move the data to the new space. 

realloc also works \i ptr points to a block freed since the last 
call of malloc, realloc, or calloc; thus sequences of free, malloc 
and realloc can exploit the search strategy of malloc to do 
storage compaction. 

calloc allocates space for an array of nelem elements of size 
elsize. The space is initialized to zeros. 

Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for storaqe 
of any type of object. 

Note that search time increases when many objects have 
been allocated; that is, if a program allocates but never frees 
then each successive allocation takes longer. For an 
alternate, more flexible implementation, see the description 
for the fast version of malloc. 



Diagnostics 

malloc, realloc, and calloc return a NULL pointer if there is no 
available memory or if the arena has been detectably 
corrupted by storing outside the bounds of a block When 
this happens, the block pointed to by ptr may be destroyed. 

See Also 

brk in Section 2; malloc (fast version). 
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Name 

matherr - error-handling function 

Format 

# include <math.h> 

i n t ma t he r r ( x) 
struct exception ' x ; 

Description 

The matherr function is invoked by functions in the Math 
Library when errors are detected. Users may define their own 
procedures for handling errors, by including a function named 
matherr in their programs, matherr must be of the form 
described above. When an error occurs, a pointer to the 
exception structure x will be passed to the user-supplied 
matherr function. This structure, which is defined in the 
<math.h> header file, is as follows: 

struct except I on { 
Int type; 
char 'name; 

double arg1 , arg2. retval ; 

) ; 

The element type is an integer describing the type of error 
that has occurred, from the following list of constants 
(defined in the header file): 

DOMAIN argument domain error 

SING argument singularity 

OVERFLOW overflow range error 

UNDERFLOW underflow range error 

TLOSS total loss of significance 

PLQSS partial loss of significance 

The element name points to a string containing the name of 
the function that incurred the error. The variables argl and 
arg2 are the arguments with which the function was invoked. 
Retval is set to the default value that will be returned by the 
function unless the user's matherr sets it to a different value. 
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If the user's matherr function returns non-zero, no error 
message will be printed, and errno will not be set. 

If matherr is not supplied by the user, the default 
error-handling procedures, described with the math functions 
involved, will be invoked upon error. These procedures are 
also summarized in Table 3-7, below. In every case, errno is 
set to EDOM or ERANGE and the program continues. 

Table 3-7 Default Error Handling Procedures 

Types of Errors 



ERANGE ERANGE 

M.O 



type 


DOMAIN 


SINR 
uinu 


nucDci nui 
UVcnrLUW 


UNDERFLOW 


ermo 


EOOM 


EOOM 


ERANGE 


FRANCE 


BESSEL: 




- 


- 


- 


yO, yl, yn 










(arg -< 0) 


M,-H 








EXP: 






H 


0 


L0G.L0G10: 










(arg < 0) 


M,-H 


- M,-H 






larg - 0) 








POW: 










neg"non-int 






+/-H 


0 


0"non-pos 


M.O 








SORT: 


M,0 








GAMMA: 




M.H 


H 




HYP07: 






H 




SINH: 






+/-H 




COSH: 






H 




SIN, COS, 










TAN: 










ASIN, 


M.O 








ACQS, 








ATAN2: 











M.O 
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Abbreviations 



• 


As much as possible of the value is returned. 


M 


Message is printed (EDOM error). 


H 


HUGE is returned. 


-H 


-HUGE is returned. 


+/-H 


HUGE or -HUGE is returned. 


0 


0 is returned. 



Example 

# include <math.h> 
I nt 

ma t he r r ( x ) 
register struct exception *x; 
( 

switch (x->type) { 
case DOMAIN: 

/•change sqrt to return sqrt(-argl), not 0'/ 

If ( I s t r cmp ( x ->n ame , "sqrt")) 1 
x->retval - sq r t ( x ->a r g 1 ) ; 

return (0); /'print message and set errno'/ 

} 

case SING: 

/"all other domain or sing errors,"/ 
/•print message and abort'/ 

fprlntf (stderr, "domain error in%s\n". x->name) 
abor t ( ) ; 
case PLOSS: 

/•print detailed error message*/ 

Iprintf (stderr, 'loss of significance in%s(%g) 

%g\n", x->name, x->arg1, x->retval); 
return (1): /Make no other action'/ 

) 

return (0); /'all other errors,'/ 

/'execute default procedure'/ 
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Name 

memccpy, memchr, memcmp, memcpy, memset - memory 
operations " ~ ' 

Format 

#include <memory.h> 

char Tnemccpy (si. s2, c, n) 
cha r • s > . * s2; 
Int c , n ; 

char 'memchr (s, c, n) 
char * s ; 
I n t c , n ; 

int memcmp (sJ, s2, n) 
char *sJ, 's2; 
int n; 

char 'memcpy (sf, s2, n) 
char 'ai, ' $2; 
Int n; 

char 'memset (s, c, n) 
char * s ; 
int c , n : 

Description 

These functions operate efficiently on memory areas (arrays 
of characters bounded by a count, not terminated by a null 
character). They do not check for the overflow of any 
receiving memory area. 

memccpy copies characters from memory area si into s2 
stopping after the first occurrence of character c has been 
copied, or after n characters have been copied, whichever 
comes first. It returns a pointer to the character after the 
copy of c in s 1, or a NULL pointer if c was not found in the 
first n characters of s2. 
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memchr returns a pointer to the first occurrence of character c 
in the first n characters of memory area s, or a NULL pointer 
if c does not occur. 

memcmp compares its arguments, looking at the first n 
characters only, and returns an integer less than, equal to, or 
greater than 0, according ass/ is lexicographically less than, 
equal to, or greater than s2. 

memcpy copies n characters from memory area s2 to s 7. It 
returns s1 . 

memset sets the first n characters in memory area s to the 
value of character c. It returns s. 

For user convenience, all of these functions are declared in 
the optional <memory.h> header file. 

Known Problems 

memcmp uses native character comparison, which is signed on 
some machines, but not on others. ASCII values are always 
positive, so programs that compare only ASCII values are 
portable. 

Overlapping moves may yield surprises. 
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Name 

mktemp - make a unique file name 

Format 

char 'mktemp (template) 
char * t emp late; 

Description 

The mktemp function replaces the contents of the string 
pointed to by temp/ate by a unique file name, and returns the 
address of the temp/ate. The string in temp/ate should look 
like a file name with six trailing Xs; mktemp will replace the Xs 
with a letter and the current process ID. The letter will be 
chosen so that the resulting name does not duplicate an 
existing file. 

Known Problems 

It is possible to run out of letters. 

See Also 

getpid in Section 2, tmpfile, tmpnam. 
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Name 

monitor - prepare execution profile 

Format 

# include <mon.h> 

void monitor {lowpc, hlghpc, buffer, butsize, n 
lot {• lowpc) () . C highpc) () : 
WORD 'buffer: 
Int butsize, nfunc; 



Description 

An executable program created by cc -p (see Section 1 ) 
automatically includes calls for monitor with default 
parameters; monitor need not be called explicitly except to 
gain fine control over profiling. 

monitor is an interface to the profil system call (see Section 2). 
Lowpc and highpc are the addresses of the two functions; 
buffer is an address of a (user supplied) array of bufsize 
WORDs (defined in the <mon.h> header file), monitor arranges 
to record a histogram of periodically sampled values of the 
program counter, and of counts of calls of certain functions, 
in the buffer. The lowest address sampled is that of lowpc. 
and the highest is just below highpc. Lowpc may not equal 0 
for this use of monitor. At most nfunc call counts can be kept; 
only calls of functions profiled with the profiling option -p of 
ce are recorded. (The C Library and Math Library supplied 
when cc -p is used also have call counts recorded.) 

For the results to be significant, especially where there are 
small, heavily used routines, it is suggested that the buffer be 
no more than a few times smaller than the range of locations 
sampled. 

To profile the entire program, it is sufficient to use 

extern etext ( ) ; 

monl tor(maln, etext. butter, bufsize, nfunc); 
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Etext lies just above all the program text; see end, earlier in 
this section. 

To stop execution monitoring and write the results on the file 
mon.out, use 

mo n I t o r ( 0 ) ; 

The prof command (see Section 1 ) can be used to examine 
the results. 



Files 

mon.out 

/lib/libp/libc.a 

lib/libp/libm.a 



See Also 

cc, prof in Section 1 ; profit in Section 2; end. 
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Name 

nlist - get entries from the name list 

Format 

#1 nc I ude <n I 1st . h> 

i n t nlist ( f I la-name . nl) 
char * f i la-name; 
struct nlist * n I ; 



Description 

The nlist function examines the name list in the executable 
file whose name is pointed to by file-name, and selectively 
extracts a list of values and puts them in the array of nlist 
structures pointed to by nl. The name list nl consists of an 
array of structures containing names of variables, types and 
values. The list is terminated with a null name; that is, a null 
string is in the name position of the structure. Each variable 
name is looked up in the name list of the file. If the name is 
found, the type and value of the name are inserted in the 
next two fields. The type field will be set to 0 unless the file 
was compiled with the -g option. If the name is not found, 
both entries are set to 0. See a.out in Section 4 for a 
discussion of the symbol table structure. 

This function is useful for examining the system name list 
kept in the file /unix. In this way, programs can obtain 
system addresses that are up to date. 

The <nlist.h> header file is automatically included by 
<a.out.h> for compatibility. However, if the only information 
needed from <a.out.h> is for use of nlist, then including 
<a.out.h> is discouraged. If <a.out.h> is included, the line 
"#undef n_name" may need to follow it. 
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Diagnostics 

All value entries are set to 0 if the file cannot be read or if it 
does not contain a valid name list. 

nlist returns -1 upon error; otherwise, it returns 0. 



See Also 

a.out in Section 4. 
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Name 

ocurse - optimized screen functions 



Format 

#lnc1ude <oourse.h> 



Description 

ocurse is the old Berkeley curses library that uses termcap (see 
Section 4). 

These functions optimally update the screen. 

Each curses program begins by calling initscr and ends by 
calling endwin. 

Before a program can change a screen, it must specify the 
changes. It stores changes in a variable of type WINDOW by 
calling curses functions with the variable as argument. Once 
the variable contains all the changes desired, the program 
calls wrefresh to write the changes to the screen. 

Most programs need only a single WINDOW variable, ocurse 
provides a standard WINDOW variable for this case and a 
group of functions that operate on it. The variable is called 
stdscr, its special functions have the same name as the 
general functions minus the initial w. 



Functions 

addch(cft) 

addstr(srr) 

box(win,vert,hoi) 

crmode() 

clear() 

c\mok(scr,boolfj 

clrtobotl) 

clrtoeolO 

delch() 

deleteln() 



Add a character to stdscr. 
Add a string to stdscr. 
Draw a box around a window. 
Set cbreak mode. 
Clear stdscr. 
Set clear flag for scr. 
Clear to bottom on stdscr. 
Clear to end of line on stdscr. 
Delete a character. 
Delete a line. 
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delwin(i*w) 

echo() 

endwin() 

erase!) 

getchj) 

getcap(name) 

getstrfsf/) 

gettmodej) 

getyx(wm,)',A) 

inch() 

initscrf) 

insch(c) 

insertln() 

leaveok( win.boolf) 
\anQname(termbuf.name) 
move[y,xj 



Delete win. 
Set echo mode. 
End window modes. 
Erase stdscr. 

Get a char through stdscr. 
Get terminal capability name. 
Get a string through stdscr. 
Get tty modes. 
Get {y,$ coordinates. 
Get char at current [x,y) coordinates. 
Initialize screens. 
Insert a character. 
Insert a line. 
Set leave flag for win. 
Get long name from termbuf. 
Move to (y,*) on stdscr. 



imair[lasty,lastx,newy,new$ Actually move cursor. 
nevm'm(lines,cols,begin-y,begin^l 

Create a new window 



nil) 

nocrmode() 
noecho() 
nonl() 
noraw() 

overlay! wint,win2) 
overwrite! win1,win2) 
pnttoN[fmt,8rg1.arg2,...) 

raw() 
refresh)) 
resetty!) 
savetty!) 

szmw[fmt,arg1,arg2,...) 

scroll(w//j) 
scrollok! win.boolf) 
setterm(name) 
standend() 
standout!) 

svimm[win,linBs,cols,begin^y,begin-^ 

Create a subwindow. 
touchwin(wm) Change all of win. 

unctrl(c/i) Printable version of cb. 



Set newline mapping. 
Unset cbreak mode. 
Unset echo mode. 
Unset newline mapping. 
Unset raw mode. 
Overlay winl on win2. 
Overwrite winl on top of win2. 

Printf on stdscr. 
Set raw mode. 

Make current screen look like stdscr. 
Reset tty flags to stored value. 
Stored current tty flags. 

Scanf through stdscr. 
Scroll win one line. 
Set scroll flag. 
Set term variables for name. 
End standout mode. 
Start standout mode. 
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waddch(ww,c/)) 

waddstr(w//),sfr) 

wclear(w/n) 

w:lrtobot(iv;n) 

wclrtoeol(tv/n) 

wdelch(w/n,c) 

wdeleteln(rtOT) 

werase(wm) 

wgetch(w//i) 

wgetstr) win.sti) 

winch(w/o) 

winsch(iv/n,c) 

winsertln(tv/>?) 

wmove{win,y,ji\ 

vipnnbN(win,fmt,arg1,arg2,.. 

wrefresh(w/n) 

wscanw( win.fmt.arg 1,arg2,. . 

wstandend(w;n) 

wstandout(vwn) 



Add character to win. 
Add string to win. 
Clear win. 

Clear to bottom of win. 
Clear to end of line on win. 
Delete char from win. 
Delete line from win. 
Erase win. 

Get a char through win. 

Get a string through tv/in. 

Get char at current (y,x) in win. 

Insert char into w/n. 

Insert line into win. 

Set current (y,x) coordinates on ww. 

Printf on w/n. 

Make screen look like win. 

Scanf through win. 

End standout mode on win. 

Start standout mode on win. 



Files 

/usr/include/ocurse.h - header file 
/usr/lib/libocurse.a - curses library 
/usr/lib/libtermcap.a - termcap library, used by curses 

See Also 

stty in Section 2; setenv; termcap in Section 4. 
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Name 

ofCreate, ofChangeFileLength, of Delete - allocate BTOS files 

Format 

ofCreate ( pbF i I eSpec , cbFileSpec, pbPassword, cbPassword, 

IfaFI leSIze) 
char * pbF 1 1 eSpec , 
short cbF i I eSpec ; 
char 'pbPassword; 
short cbPassword; 
long IfaFlloSlza; 

ofChangeFlleLength(//>, / faNewFI leSIze) 
shor t fh ; 

long I faNewF 1 1 eSi ze: 

ofDe lete( fh) 
sho r t th ; 

Description 

The ofCreate function calls the BTOS CreateFile service, which 
creates a BTOS file. Arguments are: 

o PbFileSpec and cbFileSpec specify the location and size of 
the new file's name. CENTIX processes lack a BTOS 
default path, so the name must begin with a volume name 
in square brackets [...], and a directory name in angle 
brackets <...>. The specified volume and directory must 
already exist. The file name that follows the volume and 
directory specifications can be up to 50 characters: upper 
case and lower case letters, digits, periods (.), hyphens {-), 
and right angle brackets (>). Here is an example with 
everything: 

[sys]<sys>Big1 .subd>doc-Old 

ofCreate fails if the specified directory already has a file with 
the specified name. BTOS does not consider two file 
names distinct if they differ only in the case of their letters. 
However, a BTOS directory preserves the case of letters 
as specified by ofCreate. 
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a PbPassword and cbPassword specify the location and size 
of the password that authorizes creation of the file. This 
password must match the volume or directory password. If 
the volume or directory lacks a password, no password is 
needed; set cbPassword to 0 and pbPassword to anything. 
(To give the file itself a password, see ofstatus.) 

□ LfaFileSize is the initial size of the file. The size must be a 
multiple of 512. 

See ofOpenFileto provide a path handle for a newly created file. 

The ofChangeFileLength function calls the BTOS ChangeFileLength 

service, which resets the length of a file. Arguments are: 

□ Fh is a file handle returned by ofOpen. 

□ LfaNewFileSize is the new size of the file. The size must be 
a multiple of 512. 

The ofDelete function calls the BTOS DeleteFile service, which 
deletes a file. Fh is a file handle returned by an ofOpen in 
modify mode. 

The program must be loaded with the library flag -Ictos. 

Diagnostics 

0 indicates success. ofCreate returns 224 if the file already exists. 

Caution 

Frequent cails to ofOpen and CloseFile on a nearly full volume 
result in files whose contents are scattered about the disk. 
BTOS must add additional header blocks to the disk to keep 
track of the fragments. Frequent calls to ofChangeFileLength can 
have the same effect. 

See Also 

ofOpenFile, ofRead, ofDir, ofStatus, ofRename. 
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Name 

ofCrDir, ofDIDir, ofReadDirSector - BTOS directory functions 

Format 

OfCrDir (pbDirSpec, cbDIrSpec. pbVo I Password , cbVo I Pass wo r d , 

pbDI rPassword, cbD I r Pa s sword , cSeclors, 

de f a u 1 1 F l l eProtec 1 1 onLeve I ) 
char ' pbDI rSpec; 
short cbDirSpac; 
char • pbVolPassword; 
short cbVo I Password; 
char ' pbDI rPassword; 
short cbDi rPassword; 
short cSac tors; 

short de fau I I F i laProtact lonLeve I ; 

ofDIDir (pbDirSpec, cbDIrSpec, pbPassword, cbPassword) 
char • pbDI rSpec; 
short cbDirSpac; 
char 'pbPassword; 
short cbPassword; 

ofReadDirSector (pbDirSpec, cbDIrSpec, pbPassword, 

cbPassword , ISector, pBuf ferRet) 
char ' pbDI rSpec; 
short cbDIrSpec; 
char 'pbPassword; 
short cbPassword; 
short ISector; 
char * pBul ferRet; 
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Description 

The ofDir function calls the BTOS CreateDir service, which 
creates a BTOS directory. It takes the following arguments: 

□ PbDirSpec and cbDirSpec specify the location and size of 
the directory name. CENTIX processes lack a BTOS file 
path sp the name must begin with a volume name in 
square brackets [...]. Angle brackets around the directory 
name (< >) are optional. The specified volume must 
already exist. The directory name that follows the volume 
specification can be up to 12 characters: upper case and 
lower case letters, digits, periods (.), and hyphens (-). Here 
is an example with everything: 

[sys]<DH. 1 -Changes> 
ofCrDir fails if the specified volume already has a directory 
with the specified name. BTOS does not consider two 
directory names as distinct if they differ only in the case of 
their letters. However, the BTOS volume control structures 
preserve the case of letters as specified by ofCrDir. 

□ PbVolPassword and cbVolPassword specify the location and 
size of a password to be compared with the volume 
password. If the volume lacks a password, set 
cbVolPassword to 0 and pbVolPassword to anything. 

□ PbDirPassword and cbDirPassword specify the location and 
size of the password to be assigned to the directory. If the 
directory is to have no password, set cbDirPassword to 0 
and pbDirPassword to anything. 

□ Csectors is the size of the directory in sectors. In general, 
one sector can store information on 15 files, but this 
depends on the length of the file names. 

□ DefaultFileProtectionLevel indicates the initial protection of 
files in the directory 
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The ofDIDir function calls the BTOS DeleteDir service, which 
deletes an empty directory. Delete or move all files from a 
directory before deleting the directory. ofDIDir takes the 
following arguments: 

o PbDirSpec and cbDirSpec specify the location and size of 
the directory name. This name follows the same 
conventions used by ofCrDir. 

□ PbPassword and cbPassword specify the location and size 
of the password that authorizes the deletion of the 
directory. This password must match the volume 
password or the directory password. If volume or directory 
teck a password, no password is required to delete the 
directory.: set cbPassword to 0 and pbPassword to 
anything. 

The ofReadDirSector function calls the BTOS ReadDirSector 
service, which reads a single 512-byte directory sector It 
takes the following arguments: 

□ PbDirSpec and cbDirSpec specify the location and size of 
the directory name. This name follows the same 
conventions used by ofCrDir. 

□ PbPassword and cbPassword specify the location and size 
of the password that authorizes access of the directory 
This password must match the volume password or the 
directory password. If the volume or directory lack a 
password, no password is required to delete the directory 
set cbPassword to 0 and pbPassword to anything. 

□ /Sector specifies which sector to read. Sectors are 
numbered from 0. 

□ PBufferRet points to a 512-byte area that will receive the 

SGCTOr. 

The program must be loaded with the library flag -Ictos. 
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Diagnostics 

0 indicates success. ofCrDir returns 240 ("Directory already 
exists") if the specified volume already has a directory with 
the specified name. ofDIDir returns 241 ("Directory not 
empty") if the directory still has files in it. 

See Also 

ofCreate, ofOpenFile, of Read, ofStatus, ofRename. 
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Name 

ofOpenFile, ofCloseFile, ofCloseAIIFiles - access BTOS files 

Format 

ofOpenFile {pFhRet, pbFI leSpec, cbFileSpec, 

pbPassword , cbPas sword , mode) 
short 'pFhRet; 
char * pbFI leSpec; 
short CbFileSpec; 
char 'pbPassword; 
short cbPassword; 
short mode; 

olCloseFi te { fh) 
short fh; 

ofCioseAl I F i las ( ) 

Description 

The ofOpenFile function calls the BTOS OpenFile service, which 
opens an existing BTOS file. ofOpenFile takes the following 
arguments: 

a PFhRet specifies where ofOpenFile is to return the file handle. 
This value is similar in use to a CENTIX file descriptor. 
Functions that do I/O, reallocate, and delete files require a 
valid file handle. 

□ PbFileSpec and cbFileSpec specify the location and length 
of the file name. CENTIX processes lack a BTOS default 
path, so the name must begin with a volume name in 
square brackets [...], and a directory name in angle 
brackets <...>. The remainder of the name must match a 
name in the specified directory, except that letters in the 
two names can differ in case. See ofCreate. 

□ PbPassword and cbPassword specify the location and size 
of a password that authorizes access to the file. The 
password required depends on the protection level of the file. 
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a Mode specifies the access mode: 'm'*256 + 'r' for reading, 
m'*256 + 'm' for modifying. 

A process that has file open in modify mode is the only 
process that can have the file open at all. An attempt to 
open a file in modify mode will fail if any other process 
already has that file open. An attempt to open a file in any 
mode will fail if another process already has that file open in 
modify mode. 

Suppose you want to open for reading a file on volume sys 
and directory sys called danno.user. The following example 
works if no password is required: 

I nmp« " [ sys ]<sys>danno .user"; 

I I ( (ercofOpenFI le(SJhandle, r nmp , s t r I en ( f nmp) . 0, 0, 

m' •256+' r • ) ) I- 0) ) 
p r ! n t f ( "BTOS open error %d\n", ere); 

The ofCloseFile function calls the BTOS CloseFile service, which 
closes a file. Fh is a file handle previously provided by ofOpenFile. 

ofCloseAIIFiles closes all the process's BTOS files. 



Diagnostics 

0 indicates success. If a modify mode ofOpenFile returns 220 
( "File in use"), some other process has the file open for 
reading or modifying. If a read mode ofOpenFile returns 220, 
some other process has the file open for modifying. 

See Also 

ofCreate, ofRead, ofDir, ofStatus, ofRename, ofDir. 
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Name 

ofRead, ofWrite - input/output on a BTOS file 

Format 

ofRead ( fh, pButferRet , sButterMax. ifa, psDataRet) 

short fh ; 

char * pBuf terRet ; 

short SBufferMax; 

long Ifa; 

union { 

char • psDataRet 

short 'DataRet 

): 



ofWrite (fh, pBuffer, sButfer. Ifa, psDataRet) 

short fh; 

char 'pBuffer; 

short SButfer; 

long Ifa; 

union { 

char * psDa taRet 

short 'DataRet 

}; 



Description 

The ofRead function calls the BTOS Read service, which inputs 
one or more sectors from a BTOS file. It takes the followinq 
arguments: 

o Fh is a file handle previously returned by ofOpen. 

□ pBufferRet points to a region large enough to hold the 
sector(s) read. The region must be on an even address- a 
union with a "short int" will force this. 

d sBufferMax is the number of bytes desired. This must be a 
multiple of 512. 

o Lfa is the offset, from the beginning of the file, of the first 
byte to be read. This must be a multiple of 512. 
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□ psDataRet indicates where ofRead is to return the number of 
bytes actually read. This should point to a short word to work. 

Note that you must read or write in multiples of 512 bytes. 

The ofWrite function calls the BTOS Write service, which 
outputs one or more sectors. It takes the following 
arguments: 

o Fh is a file handle previously returned by openFile. 

□ PBuffer points to the data to be output. The data must 
begin at an even address. 

□ SBuffer indicates the number of bytes to be output. This 
must be a multiple of 512. 

Lfa indicates the offset, from the beginning of the file, to 
which the data is to be written. This must be a multiple of 5 1 2 . 

□ PsDataRet indicates where ofWrite is to return the number 
of bytes actually written. 

The program must be loaded with the library flag -Ictos. 

Diagnostics 

0 indicates success. ofWrite returns 2 ("End of medium") if 
you attempt to write past the end of the file. 

Caution 

If a BTOS process has written (or will read) binary integers to 
(from) the file, it stored (expects) them with Intel-byte 
ordering. See swapshort. 

See Also 

ofCreate, ofOpen, ofDir, ofStatus, ofRename, swapshort. 
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Name 

ofRename - rename a BTOS file 



Format 

ofRename (fh, pbNewF 1 1 eSpec , cbNewF 1 1 eSpec . pbPasswor 

cbPassword) 
short fh; 

char • pbNewFi l eSpec; 
short CbNewF I I eSpec; 
char • pbPes swo r d ; 
short cbPassword; 

Description 

The ofRename function calls the BTOS RenameFile service, 
which renames a BTOS file. It takes the following arguments: 

□ Fh is a file handle returned by an openFile in modify mode. 
This indicates the file to be renamed. 

o PbNewFileSpec and cbNewFileSpec specify the location and 
size of the file's new name. The file name must include the 
volume and directory names. The file name conventions 
are the same as those for ofCreate. 

□ PbPassword and cbPassword specify the location and size 
of a password that authorizes the insertion of a file in the 
specified directory. This password must match the volume 
or directory password. If volume or directory lacks a 
password, no password is needed; set cbPassword to 0 
and pbPassword to anything. 

The program must be loaded with the library flag -Ictos. 



Diagnostics 

0 indicates success. 
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Caution 

A rename to a new directory is meaningful; a rename to a 
new volume is not. 



See Also 

ofCreate, ofOpenFile, ofRead, ofDir, ofStatus. 
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Name 

ofGetFileStatus, ofSetFileStatus - BTOS file status 

Format 

OfGetFileStatus (fh. statusCode, pStatus, sStatus) 



short f/i; 
short statusCode; 
char 'pStatus; 
short sStatus; 

OfSetFileStatus ( fh, statusCode. pStatus, sStatus) 

short fh; 

short statusCode; 

char 'pStatus; 

short sStatus; 



Description 

The ofGetFileStatus and ofSetFileStatus functions call the BTOS 
GetFileStatus and SetFileStatus services, which get and set file 
information. They take the following arguments: 

□ Fh is a handle returned by a BTOS OpenFile in modify mode. 
StatusCode specifies the information to be obtained or 
changed. StatusCode must be one of the codes shown in 
Table 3-8. ofSetFileStatus only sets the items marked as 
settable. 

Table 3-8 BTOS File Status Codes 



Code 

0 



Item 

File Length 
File Type 

File protection level 
Password 

Date/time of creation 
Date/time last modified 
End-of-file pointer 
File Header Block 
Volume Home Block 
Device Control Block 
FHB Application Field 



Size 
4 



No 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

No 

No 

Yes 



Settable? 



2 
3 
4 
5 
6 
7 
8 
9 

10 



f1 
13 
4 
4 
4 
512 
256 
100 
64 
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o Pstatus and sStatus specify the location and size of the 
area that holds, or is to receive, the data. If the area is not 
big enough, ofGetFileStatus right truncates the data to fit. 
When setting the password, use sStatus to indicate the 
password length. When getting the password, get the 
password length from the first byte in the data area. 

A BTOS time is represented by the following formula: 

(d * 0x20000) + (m * 0x10000) + s 

where d is the number of days since the beginning of March, 
1952 (in the local time zone); m is 0 for midnight/AM, 1 for 
noon/PM; s is the number of secondes since the last 
midnight or noon. 

The program must be loaded with the library flag -Ictos. 

Diagnostics 

0 indicates success. 

See Also 

ofCreate, ofOpenFile, of Read, ofDir, ofRename. 
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Name 

perror, ermo, sys_errlist, sys_nerr - system error messages 

Format 

void perror (s) 
char • s ; 

extern Int err no; 

extern char • sys_e r r I I s t [ ] ; 

extern int sys_nerr; 

Description 

The perror function produces a message to the standard error 
output, describing the last error encountered during a call to 
a system or library function. The argument string s is printed 
first, then a colon and a blank, then the message and a 
new-line. To be of most use, the argument string should 
include the name of the program that incurred the error. The 
error number is taken from the external variable errno, which 
is set when errors occur but not cleared when non-erroneous 
calls are made. 

To simplify variant formatting of messages, the array of 
message strings sys_errlist is provided; ermo can be used as 
an index in this table to get the message string without the 
new-line. sys_nerr is the largest number provided for in the 
table; it should be checked because new error codes may be 
added to the system before they are added to the table. 

See Also 



intro. 
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Name 

popen, pclose - initiate pipe to/from a process 



Format 

#1 nc I ude <s t d i o . h> 



FILE 'popen {command, type) 
char 'command, 'type; 



Int pclose {stream) 
FILE "stream; 



Description 

The arguments to popen are pointers to null-terminated strings 
containing, respectively, a shell command line and an I/O 
mode, either r for reading or w for writing, popen creates a 
pipe between the calling program and the command to be 
executed. The value returned is a stream pointer such that 
you can write to the standard input of the command, if the 
I/O mode is w, by writing to the file stream; and you can read 
from the standard output of the command, if the I/O mode is 
r, by reading from the file stream. 

A stream opened by popen should be closed by pclose, which 
waits for the associated process to terminate and returns the 
exit status of the command. 

Because open files are shared, a type r command may be 
used as an input filter and a type w command as an output filter. 



Diagnostics 

popen returns a NULL pointer if files or processes cannot b 

created, or if the shell cannot be accessed. 

pclose returns -1 if stream is not associated with a popened 

command. 
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Known Problems 

If the original and popened processes concurrently read or 
write a common file, neither should use buffered I/O 
because the buffering gets all mixed up. Problems with ar 
output filter may be forestalled by careful buffer flushinq 
such as with fflush (see fclose). 

See Also 

pipe, wait in Section 2, fclose, fopen, system. 
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Name 

printf, fprintf, sprint! - print formatted output 

Format 

#1 nc I ude <s td i o . h> 

int print I {format{. arg]...) 
char " forma t ; 

int fprintf {stream, formatl, arg}...) 
FILE 'stream; 
char * forma t ; 

int sprlntf (s. formatl. arg]...) 
char *s. format; 

Description 

The printf function places output on the standard output 
stream stdout. fprintf places output on the named output 
stream, sprintf places "output," followed by the null character 
(\0), in consecutive bytes starting at *s; it is the user's 
responsibility to ensure that enough storage is available. Each 
function returns the number of characters transmitted (not 
including the \0 in the case of sprintf), or a negative value if 
an output error was encountered. 

Each of these functions converts, formats, and prints its args 
under control of the format. The format is a character string 
that contains two types of objects: plain characters, which 
are simply copied to the output stream, and conversion 
specifications, each of which results in fetching of zero or more 

args. The results are undefined if there are insufficient args for 
the format. If the format is exhausted while args remain, the 
excess args are simply ignored. 

Each conversion specification is introduced by the character 
%. After the %, the following appear in sequence: 

d Zero or more flags, which modify the meaning of the 
conversion specification. 
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d An optional decimal digit string specifying a minimum field 
width. If the converted value has fewer characters than the 
field width, it will be padded on the left (or right, if the 
left-adjustment flag described below, has been given) 
to the field width. If the field width for an s conversion is 
preceded by a 0, the string is right-adjusted with 
zero-padding on the left. 

d A precision that gives the minimum number of digits to 
appear for the d, o, u, x, or X conversions, the number of 
digits to appear after the decimal point for the e and f 
conversions, the maximum number of significant digits for 
the g conversion, or the maximum number of characters to 
be printed from a string in an s conversion. The precision 
takes the form of a period (.), followed by a decimal digit 
string; a null digit string is treated as zero. 

o An optional I specifying that a following d, o, u, x, or X 
conversion character applies to a long integer arg. An I 
before any other conversion character is ignored. 

□ A character that indicates the type of conversion to be 
applied. 

A field width or precision may be indicated by an asterisk (*) 
instead of a digit string. In this case, an integer arg supplies 
the field width or precision. The arg that is actually converted 
is not fetched until the conversion letter is seen, so the args 
specifying field width or precision must appear before the arg 
(if any) to be converted. 

The flag characters and their meanings are: 

The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion will always begin with a 

sign (+ or -). 

0,3,1,1 If the first character of a signed conversion is not a sign, a 

blank will be prefixed to the result. This implies that if the 
blank and + flags both appear, the blank flag will be ignored. 
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This flag specifies that the value is to be converted to an 
"alternate form." For c, d, s, and u conversions, the flag 
has no effect. For an o conversion, it increases the 
precision to force the first digit of the result to be a zero. 
For x and X conversions, a non-zero result will have Ox or 
OX prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits 
follow the point (normally, a decimal point appears in the 
result of these conversions only if a digit follows it). For g 
and G conversions, trailing zeros will not be removed from 
the result (they normally are removed). 

The conversion characters and their meanings are: 

d, o, u, x, X The integer arg is converted to signed decimal, unsigned 

octal, decimal, or hexadecimal notation (x and X), 
respectively; the letters abcdef are used for x conversion 
and the letters ABCDEF for X conversion. The precision 
specifies the minimum number of digits to appear; if the 
value being converted can be represented in fewer digits, it 
will be expanded with leading zeros. (For compatibility with 
older versions, padding with leading zeros may alternatively 
be specified by prepending a zero to the field width. This 
does not imply an octal value for the field width.) The 
default precision is 1. The result of converting a zero value 
with a precision of zero is a null string. 

f The float or double arg is converted to decimal notation in 

the style "[-]ddd.ddd," where the number of digits after the 
decimal point is equal to the precision specification. If the 
precision is missing, six digits are output; if the precision is 
explicitly zero, no decimal point appears. 

e e The float or double arg is converted in the style 

"[-]d.ddd+ /-dd" where there is one digit before the 
decimal point and the number of digits after it is equal to 
the precision; when the precision is missing, six digits are 
produced; if the precision is zero, no decimal point appears. 
The E format code will produce a number with E instead of 
e introducing the exponent. The exponent always contains 
at least two digits. 



printf 

# 
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9' G The float or double arg is printed in style f or e (or in style 

E in the case of a G format code), with the precision 
specifying the number of significant digits. The style used 
depends on the value converted: style e will be used only if 
the exponent resulting from the conversion is less than -4 
or greater than the precision. Trailing zeros are removed 
from the result; a decimal point appears only if it is 
followed by a digit. 

c The character arg is printed. 

s The arg is taken to be a string (character pointer) and 

characters from the string are printed until a null character 
(\0) is encountered or the number of characters indicated 
by the precision specification is reached. If the precision is 
missing, it is taken to be infinite, so all characters up to 
the first null character are printed. A NULL value for arg 
will yield undefined results. 

% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause 
truncation of a field; if the result of a conversion is wider 
than the field width, the field is simply expanded to contain 
the conversion result. Characters generated by printf and 
fprintf are printed as if putc had been called. 

Examples 

To print the date and time in the form "Sunday, July 3, 
10:02," where weekday and month are pointers to 
null-terminated strings: 

printf(-% 8 , %s %d, %d:%.2d". weekday, mo nth, day, hour, mln); 

To print pi to 5 decimal places: 

p r i n t f ( ■ p i -%.5f, 4 * atan(I.O)); 

See Also 

ecvt, putc, scanf, stdio. 
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Name 

putc, putchar, fputc, putw - put character or word on a stream 

Format 

# i nc I ude <stdio.h> 

int putc (c, st ream) 
int c : 

FILE ' s t ream; 

i nt putchar ( c) 

int c ; 

int fputc ( c , si ream) 
int c; 

FILE * s t ream; 

int putw (w, stream) 

int w, 

FILE stream; 

Description 

putc writes the character c onto the output stream (at the 
position where the file pointer, if defined, is pointing). 
putchar(c) is defined as putc(c, stdout). putc and putchar are macros. 

The fputc function behaves like putc, but is a function rather 
than a macro, fputc runs more slowly than putc, but it takes 
less space per invocation and its name can be passed as an 
argument to a function. 

putw writes the word (or integer) w to the output stream (at 
the position at which the file pointer, if defined, is pointing). 
The size of a word is the size of the integer and varies from 
machine to machine, putw neither assumes nor causes special 
alignment in the file. 
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Output streams, with the exception of the standard error 
stream stderr, are by default buffered if the output refers to a 
file and line-buffered if the output refers to a terminal. The 
standard error output stream stderr is by default unbuffered, 
but use of freeopen (see fopen) will cause it to become buffered 
or line-buffered. When the output stream is unbuffered, 
information is queued for writing on the destination file or 
terminal as soon as written; when it is buffered, many 
characters are saved up and written as a block. When it is 
line-buffered, each line of output is queued for writing on the 
destination terminal as soon as the line is completed (that is, 
as soon as a new-line character is written or terminal input is 
requested), setbuf may be used to change the stream's 
buffering strategy. 

Diagnostics 

On success, these functions each return the value they have 
written. On failure, they return the constant EOF. This will 
occur if the file stream is not open for writing or if the output 
file cannot be grown. Because EOF is a valid integer, ferror 
should be used to detect putw errors. 

Known Problems 

Because it is implemented as a macro, putc treats incorrectly 
a stream argument with side effects. In particular, putc 
(c, *f++); doesn't work sensibly, fputc should be used 
instead. Because of possible differences in word length and 
byte ordering, files written using putw are 
machine-dependent, and may not be read using getw on a 
diffrent processor. 

See Also 

fclose, ferror, fopen, fread, printf, puts, setbuf. 
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Name 

putenv - change or add value to environment 

Format 

int putenv {string) 
char ' str I ng; 

Description 

String points to a string of the form "name -value." The putenv 
function makes the value of the environment variable name 
equal to value by altering an existing variable or creating a 
new one. In either case, the string pointed to by string 
becomes part of the environment, so altering the string will 
change the environment. The space used by string is no 
longer used once a new string-defining name is passed to putenv. 

Diagnostics 

putenv returns non-zero if it is unable to obtain enough space 
via malloc for an expanded environment; otherwise, the 
function returns zero. 

Cautions 

putenv manipulates the environment pointed to by environ, and 
can be used in conjunction with getenv. However, envp (the 
third argument to main) is not changed. 

This routine uses the malloc function to enlarge the 
environment. 

After putenv is called, environmental variables are not in 
alphabetical order. 
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A potential error is to call putenv with an automatic variable 
as the argument, then exit the calling function while string is 
still part of the environment. 



See Also 



exec in Section 2; getenv, malloc; environ in Section 5. 
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Name 

putpwent - write password file entry 

Format 

# i nc I ude <pwd . h> 

int putpwent (p, f) 
struct passwd * p ; 
FILE • f ; 

Description 

The putpwent function is the inverse of getpwent. Given a 
pointer to a passwd structure created by getpwent (or getpwuid 
or getpwnam), putpwent writes a line on the stream f, which 
matches the format of /etc/passwd. 

Diagnostics 

putpwent returns non-zero if an error is detected during its 
operation; otherwise, it returns zero. 

Caution 

The above routine uses <stdio.h>, which causes it to 
increase the size of programs, not otherwise using standard 
I/O, more than might be expected. 

See Also 

getpwent. 
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Name 

puts, fputs - put a string on a stream 

Format 

# i nc I ude <s td i o . h> 

i n t puts ( s ) 
char • s ; 

int (puts (s, stream) 
char * s ; 
FILE ' st ream; 

Description 

The puts function writes the null-terminated string pointed to 
by s, followed by a new-line character, to the standard 
output stream stdout. 

fputs writes the null-terminated string pointed to by s to the 
named output stream. 

Neither function writes the terminating null character, 
puts appends a new-line character while fputs does not. 

Diagnostics 

Both routines return EOF on error. This will happen if the 
routines try to write on a file that has not been opened for 
writing. 



See Also 

ferror, fopen, fread, printf, putc. 
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Name 

qsort - quicker sort 

Format 

void qsort ((char -)base. not, s / zeo i ( • ba s e ) . compar) 

uns I gned i n t na I . 
i n t ( ' compar ) ( ) : 

Description 

The qsort function is an implementation of the quicker-sort 
algorithm. It sorts a table of data in place. 

Base points to the element at the base of the table. Nel is the 
number of elements in the table. Compar is the name of the 
comparison function, which is called with two arguments that 
point to the elements being compared. The function must 
return an integer less than, equal to, or greater than zero, 
depending on whether the first argument is to be considered 
less than, equal to, or greater than the second. 

The pointer to the base of the table should be of type 
pointer-to-element, and cast to type pointer-to-character. 

The comparison function need not compare every byte, so 
arbitrary data may be contained in the elements in addition to 
the values being compared. 

Although declared as type pointer-to-character, the value 
returned should be cast into type pointer-to-element. 

See Also 

sort in Section 1 ; bsearch, Isearch, string. 
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Name 

quAdd - add a new entry to a BTOS queue 

Format 

quAdd (pbQueuaName , cbQuaueName, I Queue I I NoSe r v e r , 

priority, queueType. pEntry, sEntry, pDateTime, 
rape a tT ime) 

char ' pbQuaueName ; 

short cbQuaueName; 

char fQueue I t NoSe r v e r ; 

char priority; 

short queueType; 

char * pEn try; 

short sEntry; 

unsigned long • pDateT ime; 

short repeat! Ime; 



Description 

The quAdd function calls the BTOS AddQueueEntry service. A 
CENTIX process that wants to submit a request to a BTOS 
queue server creates a queue entry with quAdd. quAdd takes 
the following arguments: 

□ PbQueueName and cbQueueName describe the location and 
length of a queue name. This must be one of the queues 
mentioned in the BTOS file [sysj<sys>queue.index. 

□ FQueuelfNoServer determines the action if the queue 
manager finds that no servers are active for the specified 
queue. OxFF means to queue the entry anyway. 0 means 
abort the queue entry. 

□ Priority sets the queue entry's priority. 0 is the hiqhest 
priority, 9 is the lowest. 

□ QueueType is the type of queue. This must match the 
number given in the fourth field of the queue's entry in the 
queue index file. 
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□ PEntry and sEntry describe the size and location of entry 
data. The size and layout of this data area is conventional 
for each queue. 

□ PDateTime points to the service time. A server will serve 
the request no sooner than the service time. 

The service time must be in BTOS format: 

(d * 0x20000) + (m " 0x10000) + s 

where d is the number of days since the beginning of 
March, 1 952 (in the local time zone); m is 0 for 
midnight/AM, 1 for noon/PM; s is the number of seconds 
since the last midnight or noon. 

A service time of 0 means "undated," the queue manager 
provides servers for all undated requests before it provides 
servers for any dated requests. 

□ RepeatTime specifies a repeat interval. Unless this value is 
0, the queue manager resubmits the request repeatTime 
minutes after a queue server deletes it. Thus the request 
repeats forever, with at least repeatTime minutes between 
repetitions. A CENTIX process can terminate this loop with 
the quRemove function. 

Queue servers run under BTOS and thus expect integers to 
have Intel-byte ordering. quAdd translates queueType, the 
date, and repeatTime, but does nothing about entry data. To 
translate entry data, see swapshort. 

The program must be loaded with the library flag -Ictos. 

Files 

[sys]<sys>queue. index - master queue index 
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Diagnostics 

0 indicates success. 254 ("Queue not served") if 
fQueuelfNoServer is 0 and no servers are active on the 
specified queue. 



See Also 



quRemove, quFtead. 
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Name 

quReadNext, quReadKeyed - examine BTOS queue 

Format 

st ructQueueStatusBlock { 
long qehRe t ; 
char priority: 
char padding; 
short Se r ve rUse rNumbe r ; 
long qehNex ffle f ; 
1 ; 

quReadNext ( pbQueueName , cbQueueName. qeh, pEntryRet, 

sEnt ryRet , pS tatusBlock, sSt a t usB I ock) 
char 'pbQueueName; 
short cbQueueName; 
long qeh; 
char 'pEntryRet; 
short sEntryRet; 

struct Queues t a t usBI ock 'pSta t usBlock ; 
short sSt a t usB I ock ; 

quReadKeyed (pbQueueName , cbQueueName, pbKeyl. cbKeyl, 

oKeyl, pbKey2. cbKey2. oKey2, pEntryRet , sEntryRet, 
pStatusBlock . sSta tusBlock) 

char 'pbQueueName; 

short cbQueueName; 

char ' pbKey I ; 

short cbKeyl; 

short oKey 1 ; 

char 'pbKey2; 

short cbKey2; 

short okey2; 

char 'pEntryRet; 

short sEntryRet; 

struct QueueStatusBlock 'pStatusBlock; 
short sS t a t usB I ock ; 
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Description 

The quReadNext and quReadKeyed functions call the BTOS 
ReadNextQueueEntry and ReadKeyedQueueEntry services. A queue 
client uses quReadNext or quReadKeyed to examine a BTOS 
queue. Each call returns information on a single queue entry. 
quReadNext and quReadKeyed have the following arguments in 
common: 

□ PbQueueName and cbQueueName describe the location and 
size of a queue name. 

a PEntryRet and sEntryRet describe the location and size of 
an area that is to receive entry data. Size and layout of 
entry data is specific to each queue. If the area is smaller 
than an area's data, the data is right-truncated to fit. 

o PStatusBlock and sStatusBlock describe the location and 
size of an area that is to receive the entry's status block. If 
the area is smaller than sizeof(QueueStatusBlock), the block 
is right-truncated to fit. 

quReadNext and quReadKeyed return the following values in the 
status block: 

□ QehRet is the queue entry handle. This integer value is 
unique for each entry in the queue. 

d Priority is the priority of the entry. 

□ ServerUserNum is the BTOS user number of the queue 
server that has appropriated (marked) the request and 
plans to service it. If no server has appropriated the 
request, ServerUserNum is - 1 . 

□ QehNextRet is the queue entry handle for the next entry in 
the queue. If the current entry is the last entry in the 
queue, QehNextRet is -1 . 

The following argument is specific to quReadNext: 

□ Qeh specifies the queue entry to be read. 0 indicates the 
first queue entry; any other value must be a queue entry 
handle. 
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This example passes the data for each entry in SPL to prentry( ). 

anl - strlen(qns - "SPL"); 

tor (handle - 0; handle t- -1: handle - s t a t u s QehNex t Re t ) ( 
quReadNext (qnl . qns, handle. &data, 

s i zeof (data) . istatus, s I zeo f ( s t a t us ) ) ; 
prentry(Sstatus): 

! 

The following arguments are specific to quReadKeyed. 

□ PbKeyl and cbKeyl describe the location and size of the 
first search key. If there is no search key, set cbKeyl to 0. 

□ Okeyl is the offset of the first search string. This is the 
offset, from the beginning of the entry data, of a string 
that is to be compared with the first search key. 
quReadKeyed assumes that the first byte of this string gives 
the size of the remainder of the string. If there is no first 
search key, the function ignores oKeyJ. 

a PbKey2 and cbKey2 describe the location and size of the 
second search key. If there is no second search key, set 
cbKeyl to 0. 

□ OKey2 is the offset of the second search string. This is the 
offset, from the beginning of the entry data, of a string 
that is to be compared with the second search key. 
quReadKeyed assumes that the first byte of this string gives 
the size of the remainder of the string. If there is no 
second search key, the function ignores oKey2. 

The client that calls quReadKeyed must supply 1 or 2 search 
keys quReadKeyed returns the first entry that matches both 
search keys. If only one key is given, quReadKeyed returns the 
first entry that matches that single key. 
The program must be loaded with the library flag -Ictos. 

Files 

[sys]<sys>queue. index - master queue index 
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Diagnostics 

O indicates success. quReadNext returns 904 ( "Entry deleted") 
if another client deletes a queue entry between the time you 
get the entry's handle and the time you try to read it. 

See Also 

quRemove, quAdd. 
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Name 

quRemove - take back a BTOS queue request 

Format 

quRemove ( pbQueueName , cbQueueName. pbKeyl. cbKeyl 

oKeyl. pbKey2. cbKey2, oKey2) 
char * pbQueueName ; 
short cbQueueName; 
char 'pbKeyl: 
short cbKeyl: 
short oKeyl; 
char 'pbKey2: 
short cbKey2; 
short oKey2; 



Description 

The quRemove function calls the BTOS RemoveKeyedQueueEntry 
service. A queue client uses quRemove to delete entries from a 
BTOS queue. quRemove uses search keys to identify the 
request. It takes the following arguments: 

□ PbQueueName and cbQueueName describe the location and 
size of a queue name. 

□ PbKeyl and cbKeyl describe the location and size of the 
first search key. If there is no first search key, set cbKeyl 
to 0. 

a OKeyl is the offset of the first search string. This is the 
offset, from the beginning of the entry data, of a string 
that is to be compared with the first search key. quRemove 
assumes that the first byte of this string gives the size of 
the remainder of the string. If there is no first search key, 
the function ignores oKeyl . 

o PbKey2 and cbKey2 describe the location and size of the 
second search key. If there is no second search key, set 
cbKey2 to 0. 
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□ OKey2 is the offset of the second search string. This is the 
offset, from the beginning of the entry data, of a string 
that is to be compared with the second search key. 
quRemove assumes that the first byte of this string gives the 
size of the remainder of the string. If there is no second 
search key, the function ignores oKey2. 

The client that calls quRemove must supply 1 or 2 search 
keys. quRemove deletes the first entry that matches both 
search keys. If only one key is given, quRemove deletes the 
first entry that matches the single key, oKey2. 

The program must be loaded with the library flag -Ictos. 

Files 

[sys]<sys>queue. index - master queue index 

See Also 

quAdd, quRead. 
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Name 

rand, srand - simple random number generator 

Format 

i n t rand ( ) 

void srand {seed) 
uns I gnad seed: 

Description 

The rand function uses a multiplicative congruential random 
number generator with period 2 32 that returns successive 
pseudo-random numbers in the range from 0 to 2 15 -1 . 

srand can be called at any time to reset the random number 
generator to a random starting point. The generator is initially 
seeded with a value of 1 . 

Note that the spectral properties of rand leave much to be 
desired. The drand48 function provides a much better, though 
more elaborate, random number generator. 

See Also 

drand48. 
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Name 

regcmp, regex - compile and execute regular expression 

Format 

char 'regcmp {string1[, strlng2, ...J, (char *)0) 
char 'stringl, '$tring2, 

char 'regex (re, subjoct[, retO. ...J) 
char 're, 'subject, 'retO, ...; 

extern char ' loci; 

Description 

The regcmp function compiles a regular expression and returns 
a pointer to the compiled form. The malloc function is used to 
create space for the vector. It is the user's responsibility to 
free unneeded space so allocated. A NULL return from regcmp 
indicates an incorrect argument, regcmp has been written to 
generally preclude the need for this routine at execution time. 

The regex function executes a compiled pattern against the 
subject string. Additional arguments are passed to receive 
values back, regex returns NULL on failure or a pointer to the 
next unmatched character on success. A global character 
pointer — loci points to where the match began, regcmp and 
regex were mostly borrowed from the editor, ed (see Section 
1); however, the syntax and semantics have been changed 
slightly. The following are the valid symbols and their 
associated meanings: 

[ ] * • A These symbols retain their current meaning. 

$ atches end of a string; \n matches a new-line. 

Within brackets, the minus means "through." For example, 
[a-z] is equivalent to [abcd...xyz], which means [a through 
z]. The - can appear as itself only if used as the first or 
last character. For example, the character class expression 
[ ]-] matches the characters ] and -. 
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A regular expression followed by + means one or more 
times. For example, [0-9]+ is equivalent to [0-9][0-9]'. 



|m| {m,| (m,u) Integer values enclosed in { ) indicate the number of times 
the preceding regular expression is to be applied. The value 
m is the minimum number a u is a number, less than 256, 
which is the maximum. If only m is present (that is, (m)), 
it indicates the exact number of times the regular expression 
is to be applied. The value jm,) is analogous to 
(m.infinity). The plus ( + ) and asterisk (*) operations are 
equivalent to {1,} and {0,}, respectively. 

(...)Sn The value of the enclosed regular expression is to be 

returned. The value will be stored in the (n+1)th argument 
following the subject argument. At most ten enclosed 
regular expressions are allowed, regex makes its 
assignments unconditionally. 

(...) Parentheses are used for grouping. An operator (such as *, 

+ , { }) can work on a single character or a regular 
expression enclosed in parentheses. For example, 
(a # (cb+)*)$0. 

By necessity, all the above defined symbols are special. They 
must, therefore, be escaped to be used as themselves. 



Examples 

The following example will match a leading new-line in the 
subject string pointed at by cursor: 

char "cursor, "newcursor, "ptr; 

newcursor - regex((ptr - r egomp ( " A \n " , 0)), cursor); 
f ree(pt r ) ; 

The next example will match through the string "Testing3" 
and will return the address of the character after the last 
matched character (cursor +1 1). The string "Testing3" will be 
copied to the character array retO: 

char r e t 0 [ 9 ] ; 

char "newcursor, "name; 

name - r egcmp ( • ( ( A-Za - z ] [ A - za - zO - 9_] ( 0 , 7 ) ) $0 " , 0); 
newcursor - regex(name. " 1 23Tes t i ng321 * , retO); 



1192192 



3-188 



Library Functions 



regcmp 

The third example applies a precompiled regular expression 
in file.i (see regcmp in Section 1) against string: 

# i n c I ude 'file.i" 

char 'string, 'newcursor; 

nowcursor - regei (name , string); 

This routine is kept in /lib/libPW.a. 

Known Problems 

The user program may run out of memory if regcmp is called 
iteratively without freeing the vectors no longer required. The 
following user supplied replacement for malloc reuses the 
same vector, saving time and space. 

/'user's program'/ 

char* 
ma 1 I oc ( n ) 
uns i gned n ; 
{ 

static char rebut [512] : 

return (n <- sizeof rebut) ? rebut : NULL ; 

) 

See Also 

ed, regcmp in Section 1 ; malloc. 
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Name 

scanf, fscanf, sscanf - convert formatted input 

Format 

# i nc I uda <s t d i o . h> 

int scan! {format[. pointer] ...) 
char ' forma t : 

int fscanf (stream, tormat[. pointer] ...) 
FILE " s f ream; 
char ' I or ma t ; 

int sscanf (s, format[. pointer] ...) 
char * s . • forma t ; 

Description 

The scanf function reads from the standard input stream stdin. 
fscanf reads from the named input stream, sscanf reads from 
the character string s. Each function reads characters, 
interprets them according to a format, and stores the results 
in its arguments. Each expects, as arguments, a control 
string format, described below, and a set of pointer 
arguments indicating where the converted input should be 
stored. 

The control string usually contains conversion specifications, 
which are used to direct interpretation of input sequences. 
The control string may contain: 

1 White-space characters (blanks, tabs, new-lines or 
form-feeds) that, except in two cases described below, 
cause input to be read up to the next non-white-space 
character. 

2 An ordinary character (not %), which must match the next 
character of the input stream. 
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3 Conversion specifications, consisting of the character %, 
an optional assignment suppressing character ", an 
optional numerical maximum field width, an optional I or h 
indicating the size of the receiving variable, and a 
conversion code. 

A conversion specification directs the conversion of the next 
input field; the result is placed in the variable pointed to by 
the corresponding argument, unless assignment suppression 
was indicated by ". The suppression of assignment provides 
a way of describing an input field that is to be skipped. An 
input field is described as a string of non-space characters; it 
extends to the next inappropriate character or until the field 
width, if specified, is exhausted. For all descriptors except "[" 
and "c," white space leading an input field is ignored. 

The conversion code indicates the interpretation of the input 
field; the corresponding pointer argument must usually be of 
a restricted type. For a suppressed field, no pointer argument 
is given. The following conversion codes are legal: 

% A single % is expected in the input at this point; no assignment is done. 

d A decimal integer is expected; the corresponding argument should be an 

integer pointer. 

u An unsigned decimal integer is expected; the corresponding argument 

should be an integer pointer. 

o An octal integer is expected; the corresponding argument should be an 

integer pointer. 

x A hexadecimal integer is expected; the corresponding argument should be 

an integer pointer. 

e,f,g A floating point number is expected; the next field is converted 

accordingly and stored through the corresponding argument, which should 
be a pointer to a float. The input format for floating point numbers is an 
optionally signed string of digits, possibly containing a decimal point, 
followed by an optional exponent field consisting of an E or an e, 
followed by an optional + , -, or space, followed by an integer. 

s A character string is expected; the corresponding argument should be a 

character pointer pointing to an array of characters large enough to 
accept the string and a terminating \0, which will be added 
automatically. The input field is terminated by a white-space character. 
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c A character is expected; the corresponding argument should be a 

character pointer. The normal skip over white space is suppressed in th.s 
case- to read the next non-space character, use %1s. If a field width is 
given, the corresponding argument should refer to a character array; tne 
indicated number of characters is read, 
r Indicates string data and the normal skip over leading white space is 

suppressed. The left bracket is followed by a set of characters which 
we will call the canset, and a right bracket; the input field is the 
maximal sequence of input characters consisting entirely of characters in 
the scanset. The \ when it appears as the first character in the 
scanset, serves as a complement operator and redefines the 
scanset as the set of all characters not contained in the remainder 
of the scanset string. There are some conventions used in the 
construction of the scanset. A range of characters may 'be 
represented by the construct first-last, thus 0123456789] may be 
expressed as [0-9]. Using this convention first must be lexically 
less than or equal to last, or else the dash will stand for itself 
The dash will also stand for itself whenever it is the first or the 
last character in the scanset. To include the right square bracket as 
an element of the scanset, it must appear as the first character 
(possible preceded by a *) of the scanset, and in this case it will 
not be syntactically interpreted as the closing bracket.. The 
corresponding argument must point to a character array large 
enough to hold the data field and the terminating \0, which will be 
added automatically. At least one character must match for this 
conversion to be considered successful. 
The conversion characters d, u, o, and x ™y be preceded 
by I or h to indicate that a pointer to long or to short, rather 
Kan to int, is in the argument list. Similarly the conversion 
characters e. f, and g may be preceded by to indrctte .that* 
pointer to double, rather than to float, is in the argument list. 
The I or h modifier is ignored for other conversion characters, 
scanf conversion terminates at EOF, at the end of the control 
string, or when an input character conflicts with the control 
string. In the latter case, the offending character is left 
unread in the input stream. 

scanf returns the number of successfully matched and 
assigned input items; this number can be zero in the avert t of 
an early conflict between an input character and the control 
suing If tSe input ends before the first conflict or converse, 
EOF is returned. 

Note that trailing white space (including a new-line) is left 
unread unless matched in the control string. 
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Examples 

The call 

int i . n; f I oa t x; char name[50] • 
n - scanf ( -%d%f%s- , 4i, 4x , name); 

with the input line 

25 54.32E-1 henry 

will assign to n the value 3, to / the value 25, to x the value 
and name will contain henry\0. Or 

' n 1 ' ; 'lost x , char name' 50] ; 
(voidMcanfC%2 d %f%-d%ro-9]-, Si, &x, name); 

with input 

56789 0123 56a72 
^ri'nn'S^ 56 ^ ^ X ° *> % ^ 0123 « ^ the 

string 56\0 in name. The next call to getchar (see getc) will 
return a. 3 ' 

Diagnostics 

These functions return EOF on end of input and a short count 
tor missing or illegal data items. 

Known Problems 

The success of literal matches and suppressed assignments 
is not directly determinable. 



See Also 

getc, printf, strtod, strtol. 
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Name 

setbuf, setvbuf - assign buffering to a stream 

Format 

# i nc I ude <s t d i o . h> 

void setbuf {stream, but) 
FILE 'stream: 
char 'but ; 

i n t setvbuf {stream, but. type, size) 

FILE 'stream: 

char 'but; 

Int type, size; 



Description 

The setbuf function may be used after a stream has been 
opened but before it is read or written. It causes the array 
pointed to by bufxo be used instead of an automatically 
allocated buffer. If buf\s the NULL pointer, input/output will 
be completely unbuffered. 

A constant, BUFSIZ, defined in the <stdio.h> header file, 
tells how big an array is needed: 

char buf[BUFSIZ) 

setvbuf may be used after a stream has been opened but 
before it is read or written. Type determines how stream will 
be buffered. Legal values for type, defined in stdio.h, are: 

JOFBF Causes input/output to be fully buffered. 

jrjLBF Causes output to be line buffered; the buffer will be flushed when 

a new-line is written, the buffer is full, or input it requested. 

JONBF Causes input/output to be completely unbuffered. 

If buf\s not the NULL pointer, the array it points to will be 
used for buffering, instead of an automatically allocated 
buffer. Size specifies the size of the buffer to be used. The 
constant BUFSIZ in <stdio.h> is suggested as a good buffer 
size If input/output is unbuffered, buf and size are ignored. 
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By default, output to a terminal is line buffered, and all other 
input/output is fully buffered. 

Note that a common source of error is allocating buffer 
space as an "automatic" variable in a code block, and then 
failing to close the stream in the same block. 

Diagnostics 

If an illegal value for type or size is provided, setvbuf returns a 
non-zero value. Otherwise, the value returned will be zero. 

See Also 

fopen, getc, malloc, putc, stdio. 
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Name 

setjmp, longjmp - non-local goto 

Format 

# i nc I ude <se t jmp . h> 

int setjmp {env) 
|mp_buf env: 

void longjmp (env, val) 
jmp_buf env; 
Int val ; 



Description 

These functions are useful for dealing with errors and 
interrupts encountered in a low-level subroutine of a 
program. 

The setjmp function saves its stack environment in env 
(whose type, jmp-Jjuf, is defined in the <setjmp.h> header 
file), for later use by longjmp. It returns the value 0. 
The longjmp function restores the environment saved by the 
last call of setjmp with the corresponding env argument^ After 
longjmp is completed, program execution continues as if the 
corresponding call of setjmp (which must not itself have 
returned in the interim) had just returned the value val. longjmp 
cannot cause setjmp to return the value 0. If longjmp is invoked 
with a second argument of 0, setjmp will return 1 . All 
accessible data have values as of the time longjmp was called. 

Caution 

If longjmp is called when env was never primed by a call to 
setjmp, or when the last such call is in a funct.on that has 
since returned, absolute chaos is guaranteed. 

See Also 

signal in Section 2. 
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Name 

sinh, cosh, tanh - hyperbolic functions 

Format 

# include <math.h> 

doub la sinh ( x) 
doub Is x ; 

double cosh (x) 
doub I e x ; 

double tanh (x) 
double x; 



Description 

The sinh cosh, and tanh functions return, respectively the 
hyperbolic sine, cosine, and tangent of their arguments. 

Diagnostics 

sinh and cosh return HUGE (and sinh may return -HUGE for 

n :st:i*i sex mno to erange when the *** 

.X flE*^ Pr ° CedUreS ™ V b * Ch ^ ed w * h *• 



See Also 

matherr. 
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Name 

sleep - suspend execution for interval 

Format 

unsigned sleep (seconds) 
unsigned seconds; 

Description 

The current process is suspended from execution for the 
number of seconds specified by the argument. The actual 
suspension time may be less than that requested for two 
reasons: (1) because scheduled wakeups occur at fixed 
1 -second intervals (on the second, according to an internal 
clock), and (2) because any caught signal will terminate the 
sleep following execution of that signal's catching routine. 
Also the suspension time may be longer than requested by 
an arbitrary amount due to the scheduling of other activity in 
the system. The value returned by sleep will be the "unslept 
amount (the requested time minus the time actually slept) in 
case the caller had an alarm set to go off earlier than the end 
of the requested sleep time, or premature arousal due to 
another caught signal. 

The routine is implemented by setting an alarm signal and 
pausing until it (or some other signal) occurs. The previous 
state of the alarm signal is saved and restored. The calling 
program may have set up an alarm signal before calling sleep; 
if the sleep time exceeds the time until such an alarm signal, 
the process sleeps only until the alarm signal would have 
occurred. The caller's alarm catch routine is then executed 
just before the sleep routine returns, unless the sleep time is 
less than the time until the alarm, in which case the prior 
alarm time is reset to go off at the same time it would have 
without the intervening sleep. 

See Also 

alarm, pause, signal in Section 2. 
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Name 

spawnlp, spawnvp - execute a process on a specific 
Application Processor 

Format 

I nt 

spawnlp [apnum. directory, name, argO. arg1, 

i n t apnum; 

char 'directory; 

char 'name, 'argO, 'argl 'argn; 

I nt 

spawnvp (apnum, directory, name, argv) 

I n t apnum; 

char 'directory; 

cha r • name , ' a rgv[ J ; 

extern char * • env I ron; 



Description 

The spawn functions, spawnlp and spawnvp, execute a file on 
the specified AP, creating a new process on that processor 
The pract.cal effect is that of a fork/exec sequence with the 
following differences: 

o spawn will create the new process on any AP fork/exec 
always creates the new process on the parent processes 
application processor. 

□ A spawn process is not a child of the process that called 
spawn; it is a child of the spawn server on the designated 
AP (see spawnsrv in Section 1). Thus the process that called 
spawn cannot wait (see Section 2) for the new process's 
death, use spwait instead. Also, not all the attributes that 
are inherited across a fork are inherited across a spawn. 

□ A fork/exec is less expensive than a spawn. 



• 
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The spawn server passes the following attributes to the new 
process, based partially on the attributes of the calling process: 

□ File descriptors 0, 1 , and 2 (standard input, output, and 
error) of the new process are open to /dev/null. None of 
the calling process's file descriptors are available to the 
new process. 

a Signals caught by the calling process terminate the new 
process. Other signals (ignored by or causing termination 
of the calling process) have the same effect on the new 
process they had on the calling process. 

□ The new process inherits the following, unchanged, from 
the calling process: environment parameters (variables); file 
creation mask (umask. Section 2); effective user ID and 
group ID. 

□ If the calling process's effective user ID is 0, the new 
process inherits the calling process's real user ID and 
group ID. Otherwise, the new process's real IDs are the 
same as its effective IDs. 

The calling conventions for spawnlp and spawnvp are the same 
as for execlp and execvp (see Section 2), but with two 
additional parameters at the beginning: 

apnum The number of the AP that is to run the new process. Application 

processors are numbered from 0. Viewed from behind, APs in the 
rightmost enclosure are counted first, working left; within an 
enclosure, count left to right. See the XE 500 CENTIX 
Administration Guide. 

directory A pointer to a null-terminated string identifying the new process's 

working directory. If directory is (char *)0 (NULL in <stdio.h>), 
the new process's working directory is the same as the calling 
process's. (Use of NULL is expensive: it causes a call to pwd; see 
Section 1.) 
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Examples 

The following runs myprog in the same directory as the 
current process, but it runs on AP01 : 

#define NULL ((char *)0) 

spawnlp(01, NULL , "myprog-. "myprog-. "argl-, NULL); 

The following runs a shell on the other AP: 

spawnlp(01, ■/'. -/bin/sh-, -. S h-, ". C ". 
"cd $HOME; exec myprog", NULL); 

Diagnostics 

Both functions return -1 on error; otherwise, they return the 
process number of the new process. 

See Also 

apnum, pwd, spawn in Section 1 ; apnum, fork, signal in 
Section 2; getcwd, spwait; environ in Section 5. 
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Name 

sputl, sgetl - access long integer data in a 
machine-dependent fashion 



Format 

void sputl {value, butter) 

long value: 

cha r • but ter ; 

long sgetl (buffer) 

char • but ter ; 



Description 

The sputl function takes the four bytes of the long integer 
value and places them in memory starting at the address 
pointed to by buffer. The ordering of the bytes is the same 
across all machines. 

The sgetl function retrieves the four bytes in memory starting 
at the address pointed to by buffer and returns the long 
integer value in the byte ordering of the host machine. 

The combination of sputl and sgetl provides a 
machine-independent way of storing long numeric data in a 
file in binary form without conversion to characters. 

A program that uses these functions must be loaded with 
the object-file access routine library libld.a. 
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Name 

spwait - wait for a spawned process to terminate 

Format 

s pwa it (p/d, status) 
int pi a, 'status; 



Description 

The spwait function suspends the calling process until a signal 
is received or the process specified by process ID pid 
terminates. The specified process must have been previously 
spawned (see spawn) by the calling process. 

If status is not equal to (int *)0, the word it points to receives 
two data: 

□ The high byte gets the low byte of the specified process's 
exit (see Section 2) parameter. 

□ The low byte gets the specified process's termination 
status. If the termination status's 0200 bit is set, the 
process produced a core image when it terminated. 

Diagnostics 

If spwait returns due to the receipt of a signal, a value of -1 is 
returned to the calling process and errno is set to EINTR If 
wait returns due to a terminated spawn process, the process 
ID of the child is returned to the calling process. Otherwise a 
value of -1 is returned and errno is set to indicate the error. ' 

See Also 



spawn in Section 1 ; exit, fork, signal in Section 2; spawn. 
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Name 

ssignal, gsignal - software signals 



Format 

# i nc I ude <s i gna I . h> 

int ("ssignal (sig, action))!) 
i n t s ig. ( * act ion) ( ) ; 

int gsignal ( s i g) 
int s / g ; 



Description 

The ssignal and gsignal functions implement a software facility 
similar to signal in Section 2. This facility is used by the 
Standard C Library to enable users to indicate the disposition 
of error conditions, and is also made available to users for 
their own purposes. 

Software signals made available to users are associated with 
integers in the inclusive range 1 through 15. A call to ssignal 
associates a procedure, action, with the software signal sig; 
the software signal, sig, is raised by a call to gsignal. Raising a 
software signal causes the action established for that signal 
to be taken. 

The first argument to ssignal is a number identifying the type 
of signal for which an action is to be established. The second 
argument defines the action; it is either the name of the 
(user-defined) action function or one of the manifest 
constants SIG-DFL (default) or SIGJGN (ignore), ssignal 
returns the action previously established for that signal type; 
if no action has been established or the signal number is 
illegal, ssignal returns SIG-DFL. 
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The gsignal function raises the signal identified by its 
argument, sig: 

If an action function has been established for sig, then 
that action is reset to SIG_DFL and the action function is 
entered with the argument sig. gsignal returns the value 
returned to it by the action function. 

If the action for sig is SIGJGN, gsignal returns the value 1 
and takes no other action. 

If the action for sig is SIG_DFL, gsignal returns the value 0 
and takes no other action. 

If sig has an illegal value or no action was ever specified 
for sig, gsignal returns the value 0 and takes no other action. 

Note that there are some additional signals with numbers 
outside the range 1 through 1 5 that are used by the 
Standard C Library to indicate error conditions. Thus, some 
signal numbers outside the range 1 through 1 5 are legal, 
although their use may interfere with the operation of the 
Standard C Library. 

See Also 

signal in Section 2. 
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Name 

stdio - standard buffered input/output package 

Format 

# i n c I uds <s t d i o . h> 

FILE 'stdin, 'stdout. •stdsrr; 

Description 

These functions, as well as the other functions whose 
declarations are obtained from the #include file <stdio.h>, 
constitute an efficient, user-level I/O buffering scheme. The 
in-line macros getc and putc handle characters quickly. The 
macros getchar and putchar, and the higher-level routines fgetc , 
fgets, fprintf, fputc, fputs, fread, fscanf, fwrite, gets, getw, printf, 
puts, putw, and scanf all use or act as if they use getc and putc; 
they can be freely intermixed. 

A file with associated buffering is called a stream and is 
declared to be a pointer to a defined type FILE. The fopen 
function creates certain descriptive data for a stream and 
returns a pointer to designate the stream in all further 
transactions. Normally, there are three open streams with 
constant pointers declared in the <stdio.h> header file and 
associated with the standard open files: 

stdin Standard input file, 

stdout Standard output file, 

stderr Standard error file. 

A constant NULL (0) designates a non-existent pointer. 

An integer-constant EOF (-1) is returned upon end-of-file or 
error by most integer functions that deal with streams (see 
the individual descriptions for details). 

An integer constant BUFSIZ specifies the size of the buffers 
used by the particular implementation. 
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Any program that uses this package must include the header 
file of pertinent macro definitions, as follows: 

# i nc l ude <s t d i o . h> 

These functions and constants are declared in that header file 
and need no further declaration. The constants and the 
following functions are implemented as macros (redeclaration 
of these names is perilous): getc, getchar, putc, putchar, terror, 
feof, clearerr, and fileno. 

Diagnostics 

Invalid stream pointers will usually cause grave disorder, 
possibly including program termination. Individual function 
descriptions describe the possible error conditions. 

See Also 

open, close, Iseek, pipe, read, write in Section 2; intra, ctermid, 
cuserid, fclose, ferror, fopen, fread, fseek, getc, gets, popen, 
printf, putc, puts, scanf, setbuf, system, tmpfile, tmpnam, ungetc. 
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Name 

stdipc - standard interprocess communication package (ftok) 

Format 

#include <s y s / t y pe s . h> 
#i nc I ude <sys/ i pc . h> 

key_t ftok {path, id) 
char 'path; 
char id: 

Description 

All interprocess communication facilities require the user to 
supply a key to be used by the msgget, semget, and shmget 
system calls (see Section 2) to obtain interprocess 
communication identifiers. One suggested method for 
forming a key is to use the ftok subroutine described below. 
Another way to compose keys is to include the project ID in 
the most significant byte and to use the remaining portion as 
a sequence number. Their are many other ways to form 
keys, but it is necessary for each system to define standards 
for forming them. If some standard is not adhered to, it will 
be possible for unrelated processes to unintentionally 
interfere with each other's operation. Therefore, it is strongly 
suggested that the most significant byte of a key in some 
sense refer to a project so that keys do not conflict across a 
given system. 

ftok returns a key based on path and id that is usable in 
subsequent msgget, semget, and shmget system calls. Path 
must be the path name of an existing file that is accessible 
to the process. Id is a character that uniquely identifies a 
project. Note that ftok will return the same key for linked files 
when called with the same id and that it will return different 
keys when called with the same file but different ids. 
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Diagnostics 

ftok returns (key_t)-1 if path does not exist or if it is not 
accessible to the process. 

Caution 

If the file whose path is passed to ftok is removed when keys 
still refer to the file, future calls to ftok with the same path 
and id will returned an error. If the same file is recreated, 
then ftok is likely to return a different key than it did the 
original time it was called. 

See Also 

intra, msgget, semget, shmget in Section 2. 
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Name 

strcat, strncat. strcmp, strncmp, strcpy, strncpy, strlen, strchr, 
strrchr, strpbrk, strspn, strcspn, strtok - string operations 

Format 

# i nc I ude <s t r i ng . h> 

char ' s t rca t (si, s2) 
char * s I . ' s2 : 

char 'strncat (si, s2 , n) 
char "at, " s2 ; 
i nt n; 

I nt $ t r cmp (si, s2) 
char 'si, * s2; 

I n t st r ncmp (si. s2 . n) 
char *st, "s2; 
I nt n; 

char " s t rcpy (si, s2) 
char "si, "s2; 

char "strncpy (st, s2, n) 
char "si, * s2; 
i nt n; 

Int strlen (s) 
char * s ; 

cha r "strchr ( s , c) 
char " s , c ; 

char "strrchr (s, c) 
char "s, c; 

char strpbrk (si, s2) 
char * s f , * s 2 : 

Int strspn (si, s2) 
char "s2, *s2; 

int strcspn (si. s2) 
char "st, " s2; 

char "strtok (si, s2) 
char "st, "s2: 
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Description 

The arguments s1 , s2, and s point to strings (arrays of 
characters pointed to by a null character). The functions 
strcat, strncat, strcpy, and strncpy all alter s 7. These functions 
do not check for overflow of the array pointed to by s 7 . 

strcat appends a copy of string s2 to the end of string s7. 
strncat appends at most n characters. Each returns a pointer 
to the null-terminated result. 

The strcmp function compares its arguments and returns an 
integer less than, equal to, or greater than 0, depending on 
whether s7 is lexicographically less than, equal to, or greater 
than s2. strncmp makes the same comparison but looks at at 
most n characters. 

strcpy copies strings s2 to s 7, stopping after the null 
character has been copied, strncpy copies exactly n 
characters, truncating s2 or adding null characters to s/ if 
necessary. The result will not be null-terminated if the length 
of s2 is n or more. Each function returns s7. 

strlen returns the number of characters in s, not including the 
terminating null character. 

strchr (strrchr) returns a pointer to the first (last) occurrence of 
character c in string s, or a NULL pointer if c does not occur 
in the string. The null character terminating a string is 
considered to be part of the string. 

strpbrk returns a pointer to the first occurrence in string s 7 of 
any character from string s2, or a NULL pointer if no 
character from s2 exists in s7 . 

strspn (strcspn) returns the length of the initial segment of 
string s7, which consists entirely of characters from (not 
from) string s2. 
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strtok considers the string si to consist of a sequence of zero 
or more text tokens separated by spans of one or more 
characters from the separator string s2. The first call (with 
pointer s 1 specified) returns a pointer to the first character of 
the first token, and will have written a null character into s 1 
immediately following the returned token. The function keeps 
track of its position in the string between separate calls, so 
that on subsequent calls (which must be made with the first 
argument a NULL pointer) will work through the string s1 
immediately following that token. In this way, subsequent 
calls will work through the string si until no tokens remain. 
The separator string s2 may be different from call to call. 
When no token remains in s7, a NULL pointer is returned. 

Note that for user convenience, all of the above functions are 
declared in the optional <string.h> header file. 

Known Problems 

strcmp and strncmp use native character comparison, which is 
signed on Burroughs 68000-family processors. This means 
that characters are 8-bit signed values; all ASCII characters 
have values of at least 0; non-ASCII are negative. On some 
machines, all characters are positive. Thus programs that 
only compare ASCII values are portable; programs that 
compare ASCII with non-ASCII values are not. 

Overlapping moves may yield surprises. 
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Name 

strtod, atof - convert string to double-precision number 

Format 

doub le strtod {str, ptr) 
char • s t r , ••ptr; 

double atof ( s t r) 
char 'sir; 

Description 

The strtod function returns, as a double-precision 
floating-point number, the value represented by the character 
string pointed to by str. The string is scanned up to the first 
unrecognized character. 

strtod recognizes an optional string of "white space" 
characters (as defined by isspace in ctype), then an optional 
sign, then a string of digits optionally containing a decimal 
point, then an optional e or E, followed by an optional sign or 
space, followed by an integer. 

If the value of ptr is not (char ")NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by ptr. If no number can be formed, "ptr is set to 
str, and zero is returned. 

atoi{str) is equivalent to strtod(sf/", (char **)NULL). 

Diagnostics 

If the correct value would cause overflow, plus or minus 
HUGE is returned (according to the sign of the value) and 
errno is set to ERANGE. 

If the correct value would cause underflow, zero is returned 
and errno is set to ERANGE. 

See Also 

ctype, scanf, strtol. 
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Name 

strtol, atol, atoi - convert string to integer 

Format 

long strtol (sfr, ptr, base) 
char •sfr, ••ptr; 
i n t base ; 

long atol (sfr) 
char sfr; 

Int atoi (sfr) 
char "sfr; 

Description 

The strtol function returns, as a long integer, the value 
represented by the character string pointed to by str. The 
string is scanned up to the first character inconsistent with 
the base. Leading "white space" characters (as defined by 
isspace in ctype) are ignored. 

If the value of ptr is not (char **)NULL, a pointer to the 
character terminating the scan is returned in the location 
pointed to by ptr. If no integer can be formed, that location is 
set to sfr, and zero is returned. 

If base is positive (and not greater than 36), it is used as the 
base for conversion. After an optional leading sign, leading 
zeros are ignored, and "Ox" or "OX" is ignored if base is 16. 

If base is zero, the string itself determines the base as 
follows: after an optional leading sign, a leading zero 
indicates octal conversion, and a leading "Ox" or "OX" 
hexadecimal conversion. Otherwise, decimal conversion is 
used. 

Truncation from long to int can, of course, take place upon 
assignment or by an explicit cast. 

atol(srr) is equivalent to strtol(sfr, {char *')NULL, 10). 

atoi(srr) is equivalent to (int) strtol(siV ( {char ")NULL, 10). 
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Known Problems 

Overflow conditions are ignored. 

See Also 

ctype, scant, strtod. 
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Name 

swab - swap bytes 

Format 

void swab (from, to. nbytes) 
char • f rom, 'to; 
i n t nbytes; 



Description 

The swab function copies nbytes pointed to by from to the 
array pointed to by to, exchanging adjacent even and odd 
bytes. It is useful for carrying binary data between machines. 
Nbytes should be even and non-negative. If nbytes is odd and 
positive, swab uses nbytes^ instead. If nbytes is negative, 
swab does nothing. 
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Name 



swapshort, swaplong - translate byte orders to 
Motorola/Intel 



Format 



swaps ho r t ( s ) 
shor t s ; 

swap long ( / ) 
long / ; 



Description 

Processes that run on an XE 500 CENTIX Application 
Processor do not store integers the same way as do 
processes that run on other (BTOS) processors. CENTIX 
processes use Motorola ordering; BTOS processes use Intel 
ordering. CENTIX processes must translate integers sent to 
or received from BTOS processes. 

Library functions do this translation whenever they know an 
integer value is involved. For example, AddQueueEntry 
translates integers that are supplied for all queue entries: the 
priority, the queue type, and the data. But AddQueueEntry does 
not translate any integers in the entry data. 

swaplong translates to or from Intel four-byte integers, 
swaplong returns / with its bytes in reverse order For 
example, if / is 4885001 (0x004A8A09), swaplonq returns 
160057856 (0x098 A4A00). 

swapshort translates to or from Intel two-byte integers, 
swapshort returns s with its bytes in reverse order. 

The program must be loaded with the -Ictos library flag. 
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Name 

system - issue a shell command 



Format 

^include <stdio.h> 

i n t s y s t em [string) 
char • s r r i ng: 



Description 

The system function causes the string to be given to sh (see 
Section 1 ) as input, as if the string had been typed asa 
command at a terminal. The current process waits until the 
shell has completed, then returns the exit status of the shell 



Files 

/bin/sh 

Diagnostics 

system forks to create a child process that in turn exec's 
/bin/sh in order to execute string. If the fork or exec fails, 
system returns -1 and sets errno to indicate the error. 



See Also 

sh in Section 1; exec in Section 2. 
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Name 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal 
independent operations 

Format 

char PC ; 
char *BC: 
char 'UP; 
short ospserf; 

tgetent ( bp , name ) 
char 'bp, 'name; 

tgetnum ( Id) 
char • id; 

tgetflag [id) 
char 'id; 

char • 

tgetst r ( id, area) 
char 'id, ''area; 

char • 

tgoto (cmstr, destcol, destline) 

char " cms t r ; 

i n t destcol, des Mine; 

tputs (cp, affcnl, outc) 

register char ' cp; 

i n t at ten t ; 

i n t ( ' ou t c) ( ) ; 



Description 

These functions extract and use information from terminal 
descriptions that follow the conventions in termcap (see 
Section 4). The functions do only basic screen manipulation: 
they find and output specified terminal function strings and 
interpret the cm string, curses describes a screen updating 
package built on termcap. 
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tgetent finds and copies a terminal description. Name is the 
name of the description; bp points to a buffer to hold the 
description, tgetent passes bp to the other termcap functions; 
the buffer must remain allocated until the program is done 
with the termcap functions. 

tgetent uses the TERM and TERMCAP environment variables 
to locate the terminal description. 

□ If TERMCAP is not set, or if it is empty, tgetent searches for 
name in /etc/termcap. 

□ If TERMCAP contains the full pathname of a file (any string 
that begins with /), tgetent searches for name in that file. 

□ If TERMCAP contains any string that does not begin with / 
and TERM is not set or matches name, tgetent copies the 
TERMCAP string. 

a If TERMCAP contains any string that does not begin with / 
and TERM does not match name, tgetent searches for name 
in /etc/termcap. 
tgetent returns -1 if it could not open the terminal capability 
file, 0 if it could not find an entry for name, and 1 upon success. 

tgetnum returns the value of the numeric capability whose 
name is id. It returns -1 if the terminal lacks the specified 
capability or it is not a numeric capability, 
tgetflag returns 1 if the terminal has boolean capability whose 
name is id, 0 if it does not or it is not a boolean capability. 

tgetstr copies and interprets the value of the string capability 
named by id. tgetstr expands instances in the string of \ and 
a It leaves the expanded string in the buffer indirectly pointed to by area and 
leaves the buffer's direct pointer pointing to the end of the 
expanded string; for example: 

tgetst r ( "cl " , *pt r ) ; 

where ptr is a character pointer - not an array name, tgetstr 
returns a (direct) pointer to the beginning of the string. 
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tgoto interprets the % in a cm string. It returns cmstr with the 
% sequences changed to the position indicated by destcol 
and destlme. This function must have the external variables 
BC and UP set to the values of the be and up capabilities- if 
the terminal lacks the capability, set the external variable to 
null. If tgoto cannot interpret all the % sequences in cm it 
returns "OOPS." 

tgoto avoids producing characters that might be 
misinterpreted by the terminal interface. If expanding a % 
sequence would produce null or control-d, the function will if 
possible, send the cursor to the next line or column and use 
BC or UP to move to the correct location. Note that tgoto 

t AD S o n * 0t 8VOld P roducin 9 tabs < - a Program must turn off the 
I AB3 feature of the terminal interface (see termio, Section 6). 
This is a good idea anyway: some terminals use the tab 
character as a nondestructive space. 

tjputs directs the output of a string returned by tgetstr or tgoto 
This function must have the external variable PC set to the 
value of the pc capability; if the terminal lacks the capability 
set the external variable to null, tputs interprets any delay at' 
the beginning of the string. Cp is the string output; affent is 
the number of lines affected by the action (1 if "number of 
lines affected" doesn't mean anything); and outc points to a 
function that takes a single char argument, such as putchar 
and outputs it. 

Files 

/usr/lib/libtermcap.a - library 
/etc/termcap - data base 



See Also 



ex in Section 1; curses; term in Section 5. 
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Name 

tmpfile - create a temporary file 



Format 

# i nc I uda <stdio.h> 
FILE * tmpl 118 ( ) 



Description 

The tmpfile function creates a temporary file using a nam 
generated by tmpnam, and returns a corresponding FILE 
pointer. If the file cannot be opened, an error message i 
printed using perror, and a NULL pointer is returned. The 
will automatically be deleted when the processing it 
terminates. The file is opened for update ("w + ). 



See Also 

creat, unlink in Section 2; fopen, mktemp, perror, tmpnam. 
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Name 

tmpnam, tempnam - create a name for a temporary file 

Format 

# i nc I ude <s t d I o . h> 

char • tmpnam ( s) 

char • s ; 

char 'tempnam {dir, pfx) 

char 'dir, 'pfx; 



Description 

These functions generate file names that can safely be used 
for a temporary file. 

tmpnam always generates a file name using the path prefix 
defined as P_tmpdir in the <stdio.h> header file If s is NULL 
tmpnam leaves its result in an internal static area and returns a 
pointer to that area. The next call to tmpnam will destroy the 
contents of the area. If s is not NULL, it is assumed to be the 
address of an array of at least L_tmpnam bytes, where 
L. _tmpnam is a constant defined in <stdio.h>; tmpnam places 
its result in the array and returns s. 

tempnam allows the user to control the choice of a directory 
The argument dir points to the name of the directory in 
which the file is to be created. If dir is NULL or points to a 
string that is not a name for an appropriate directory the 
path prefix defined as P.tmpdir in the <stdio.h> header file is 
used. If that directory is not accessible, /tmp will be used as 
a last resort. This entire sequence can be upstaged by 
providing an environment variable TMPDIR in the user's 
environment, whose value is the name of the desired 
temporary-file directory. 
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Many applications prefer their temporary files to have certain 
favorite initial letter sequences in their names. Use the pfx 
argument for this. This argument may be NULL or point to a 
string of up to five characters to be used as the first few 
characters of the temporary-file name, 
tempnam uses malloc to get space for the constructed file 
name and returns a pointer to this area. Thus, any pointer 
value returned from tempnam may serve as an argument to 
free (see malloc). If tempnam cannot return the expected result 
for any reason (such as if malloc failed), or none of the above 
mentioned attempts to find an appropriate directory was 
successful, a NULL pointer will be returned. 
Note that these functions generate a different file name each 
time they are called. 

Note also that files created using these functions and either 
an fopen function or a creat system call are temporary only in 
the sense that they reside in a directory intended for 
temporary use, and their names are unique. It is the user s 
responsibility to use the unlink system call to remove the file 
when its use is ended. 



Known Problems 

If called more than 17,576 times in a single process, these 
functions will start recycling previously used names. 
Between the time a file name is created and the file is 
opened, it is possible for some other process to create a file 
with the same name. This can never happen if that other 
process is using these functions or mktemp, and the file 
names are chosen so as to render duplication by other 
means unlikely. 

See Also 

creat, unlink in Section 2, fopen, malloc, mktemp, tmpfile. 
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Name 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

Format 

# i nc I ude <ma t h . h> 

doub la sin ( x) 
doub la x ; 

doub I a cos ( x) 
doub la x ; 

double tan (x) 
double x ; 

doub I e asin ( x) 
double x ; 

doub la acos ( x ) 
double x ; 

double atan (x) 

double x ; 

double atan2 (y, x) 

double y . x ; 



Description 

sin, cos, and tan respectively return the sine, cosine, and 
tangent of their arguments, x, measured in radians. 

asin returns the arcsine of x, in the range -pi/2 to pi/2, 
acos returns the arccosine of x, in the range 0 to pi. 
atan returns the arctangent of x, in the range -pi/2 to pi/2. 
atan2 returns the arctangent of tlx. in the range -pi to pi 
using the signs of both arguments to determine the quadrant 
of the return value. 



Library Functions 



3-225 



trig 

Diagnostics 

sin cos, and tan lose accuracy when their arguments are far 
from zero. For arguments sufficiently large, these functions 
return zero when there would otherwise be a complete loss 
of significance. In this case a message indicating TLOSS 
error is printed on the standard error output. For less 
extreme arguments causing partial loss of significance, a 
PLOSS error is generated but no message is printed. In both 
cases, errno is set to ERANGE. 

If the magnitude of the argument of asin or acos is greater 
than one, or if both arguments of atan2 are zero, zero is 
returned and errno is set to EDOM. In addition, a message 
indicating DOMAIN error is printed on the standard error output. 

These error-handling procedures may be changed with the 
matherr function. 



See Also 

matherr. 
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Name 

tsearch, tfind, tdelete, twalk - manage binary search trees 

Format 

#include <search.h> 

char 'tsearch ((char •) key, (char ••) rootp, compar) 
i n t ( • compa r ) ( ) ; 

Char -tfind ((char •> key, (char ••) rootp, compar) 
i n t ( • compar) ( ) ; 

char -tdelete ((char •) key, (char ••) rootp. compar) 
i n t ( • compar ) ( ) ; 

void twalk ((char •) root, action) 
void ('action)(); 



Description 

tsearch, tfind, tdelete, and twalk are routines for manipulating 
binary search trees. They are generalized from Knuth (6.2 2) 
Algorithms T and D. All comparisons are done with a 
user-supplied routine. This routine is called with two 
arguments, the pointer to the elements being compared. It 
returns an integer less than, equal to, or greater than 0, 
according to whether the first argument is to be considered 
less than, equal to, or greater than the second argument. 
The comparison function need not compare every byte, so 
arbitrary data may be contained in the elements in addition to 
the values being compared. 

tsearch is used to build and access the tree. Key is a pointer 
to a datum to be accessed or stored. If there is a datum in 
the tree equal to 'key (the value pointed to by key), a pointer 
to this found datum is returned. Otherwise, "key is inserted 
and a pointer to it is returned. Only pointers are copied so' 
the calling routine must store the data. Rootp points to a 
variable that points to the root of the tree. A NULL value for 
the variable pointed to by rootp denotes an empty tree; in 
this case, the variable will be set to point to the datum' that 
will be at the route of the new tree. 
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Like tsearch, tfind will search for a datum in the tree, returning 
a pointer to it if found. However, if it is not found, tfind will 
return a NULL pointer. The arguments for tfind are the same 
as for tsearch. 

tdelete deletes a node from a binary search tree. The 
arguments are the same as for tsearch. The variable pointed 
to by rootp will be changed if the deleted node was the root 
of the tree, tdelete returns a pointer to the parent of the 
deleted node, or a NULL pointer if the node is not found. 

twalk traverses a binary search tree. Root is the root of the 
tree to be traversed. (Any node in a tree may be used as the 
root for a walk below that node.) Action is the name of a 
routine to be invoked at each node. This routine is, in turn, 
called with three arguments. The first argument is the 
address of the node being visited. The second argument is a 
value from an enumeration data type typedef enum {preorder, 
postorder, endorder, leaf} VISIT; (defined in the <search.h> 
header file), depending on whether this is the first, second or 
third time that the node has been visited (during a depth-first, 
left-to-right traversal of the tree), or whether the node is a 
leaf. The third argument is the level of the node in the tree, 
with the route being level zero. 

The pointers to the key and the route of the tree should be 
of type pointer-to-element, and cast to type 
pointer-to-character. Similarly, although declared as type 
pointer-to-character, the value returned should be cast into 
type pointer-to-element. 



Example 

The following code reads in strings and stores structures 
contining a pointer to each string and a count of its length. It 
then walks the tree, printing out the stored strings and their 
lengths in alphabetical order. 
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'Include <search.h> 
'include <s t d i o . h> 



struct node { /-pointers to these are stored in tree" 

char sifing; 
i n t length; 

char string_ S pace[10000); /'space to store strings"/ 

struct node nodes[500); /-nodes to store'/ 

struct node 'root - NULL; /-,„,, points to 

ma i n ( ) 
{ 

char -strptr . s t r i ng_spa ce ; 
struct node -nodeptr . nodes; 
void print _node(), twalk(); 
int i - 0, node_compa r e ( ) ; 

while (gets(strptr) I. NULL S& i ++ < 500) f 
/'set node • / 

nodept r ->s t r i ng - strptr; 
nodeptr-Xength - strlen(strptr); 
/•put node into the tree*/ 
(void) tsearch) (char •)nodeptr. &root. 

node_compa re); 
/•adjust pointers, so we don't overwrite tree-/ 
strptr +- nodept r ->length + 1; 
nodeptr++; 

} 

^ twalk(root, print_node); 
/" 

This routine compares two nodes, based on an 
alphabetical ordering of the string field. 

Int 

node_compare(node1 , node2) 
struct node *node1, node2; 

return s t r cmp ( n ode 1 - >s t r I ng , node2 - >s t r i ng ) ; 

/' 

This routine prints out a node, the first time 
twalkencountersit 

•/ 

void 

print _node(node, order, level) 

struct node - - node • 

VISIT order ; 

int level; 

f 

If (order preorder order leaf) { 

(vold)printf(-string . % 20 s, length . %d\ n - 
( * node ) ->s t r I ng , ( * node ) -> I eng t h ) ; 



Library Functions 



3-229 



tsearch 



Diagnostics 

A NULL pointer is returned by tsearch if there is not enough 
space available to create a new node. 

A NULL pointer is returned by tsearch, tfind, and tdelete if rootp 
is NULL on entry. 

If the datum is found, both tsearch and tfind return a pointer tc 
it. If not, tfind returns NULL, and tsearch returns a pointer to 
the inserted item. 



Cautions 

The root argument to twalk is one level of indirection less 
than the rootp arguments to tsearch and tdelete. 
There are two nomenclatures used to refer to the order in 
which tree nodes are visited, tsearch uses preorder, 
postorder, and endorder to respectively refer to visiting a 
node before any of its children, after its left child and before 
its riqht, and after both its children. The alternate 
nomenclature uses preorder, inorder, and postorder to refer 
to the same visits, which could result in some confusion over 
the meaning of postorder. 



Known Problems 

If the calling function alters the pointer to the root, results are 
unpredictable. 



See Also 

bsearch, hsearch, Isearch. 
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Name 

ttyname, isatty - find name of a terminal 

Format 

char 'ttyname {tildes) 
i n t t i Ides ; 

int i satty ( II ides) 
Int tildes; 



Description 

The ttyname function returns a pointer to a string containing 
the null-terminated path name of the terminal device 
associated with file descriptor fildes. 

isatty returns 1 if fildes is associated with a terminal device 0 
otherwise. 



Files 

/dev?* 

Diagnostics 

ttyname returns a NULL pointer if fildes does not describe a 
terminal device in directory /dev. 

Known Problems 

The return value points to static data whose content is 
overwritten by each call. 
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Name 

ttyslot - find the slot in the utmp file of the current user 

Format 

int ttyslot () 

Description 

The ttyslot function returns the index of the current user's 
entry in the /etc/utmp file. This is accomplished by actually 
scanning the file /etc/utmp for the name of the terminal 
associated with the standard input, the standard output, or 
the error output (0, 1 , or 2). 

Files 

/etc/utmp 

Diagnostics 

A value of 0 is returned if an error was encountered while 
searching for the terminal name or if none of the above file 
descriptors is associated with a terminal device. 

See Also 

getut, ttyname. 
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Name 

ungetc - push character back into input stream 

Format 

# i nc I ude <s t d i o . h> 

int ungetc (c, stream) 

i n t c ; 

FILE ' st ream; 

Description 

The ungetc function inserts the character c into the buffer 
associated with an input stream. The character c will be 
returned by the next getc call on that stream, ungetc returns c, 
and leaves the file stream unchanged. 

One character of pushback is guaranteed, provided 
something has already been read from the stream and the 
stream is actually buffered. In the case that stream is stdin, 
one character may be pushed back onto the buffer without a 
previous read statement. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 
The fseek function erases all memory of inserted characters. 

Diagnostics 

ungetc returns EOF if it cannot insert the character. 

See Also 

fseek, getc, setbuf. 
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Name 

vprintf, vfprintf, vsprintf - print formatted output of a varargs 
argument list 

Format 

# i nc I ude <s t d i o . h> 
#include <varargs.h> 

i n t vprintf ( forma t , ap) 
char * forma t ; 
va_l 1st ap; 

int vfprintf (stream, format, ap) 
FILE 'stream; 
char ' forma t ; 
va_l I s t ap; 

int vsprintf (s, format, ap) 
char ' s , ' forma t ; 
va_l i s t ap; 

Description 

vprintf, vfprintf, and vsprintf are the same as printf, fprintf, and 
sprintf, except that instead of being called with a variable 
number of arguments, they are called with an argument list 
defined by varargs (see Section 5). 
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Example 

The following demonstrates how vprintf could be used to 
write an error routine. 

# i nc I ude <s t d i o . h> 
#include <varargs.h> 



error should be called like 

e r r o r ( f unc t I on_name , format. arg1, arg2 ...); 

/ " VARARGSO * / 
void 

error ( va_a list) 

/'Note that the f unc t i on_name and format arguments cannot 
separately declared because of the definition of 
va r a r g s . 

"/ 

va_dc I 
{ 

va_l 1st args ; 
char * fmt : 



va_s t a r t ( a r gs ) ; 

/'print out name of function causing error*/ 
(vold)fprintf(stderr, " ERROR i n %s : " 

va_ar gs (args, char • ) ) ; 
fmt - va_arg(args, char •); 
/'print out remainder of message*/ 
( vo i d ) v f pr i n t f ( fmt . args); 
va_end (args) ; 
(vol d )abor t ( ) ; 



See Also 

printf; varargs in Section 5. 
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Name 

wmgetid - get window ID 

Format 

#includo <oa/wm.h> 

i n t wmge lid (III des ) ; 
I n t I i Ides: 

Description 

The wmgetid function returns the window ID associated with 
the file descriptor fildes. A window ID is a positive integer 
that identifies the window associated with the file descriptor. 
The ID is passed to other window management library 
functions to identify the particular window being acted upon. 
The only way to get a valid window ID is from a window 
management library call; do not use a value obtained in any 
other way. 

To get all the window IDs for a terminal, use the layout 
structure written by wmlayout or wmop. To associate a file 
descriptor with a different window, use wmsetid. 

wmgetid fails if one or more of the following are true: 

Fildes is not an open file descriptor. [EBADF] 

The indicated file does not represent a terminal, or the 
terminal cannot support window 
management. [ENOTTY] 

The window manager is not running on the 
terminal. [ENOENT] 
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Files 

/dev/tty 

/usr/lib/libwm.a - window management library 

Diagnostics 

If successful, wmgetid returns the window ID associated with 
fildes. Otherwise, -1 is returned and errno is set to indicate 
the error. 



See Also 

wm in Section 1 ; wmop, wmlayout, wmsetid. 
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Name 

wmlayout - get terminal's window layout 

Format 

#include <oa/wm.h> 

int wmlayout [tildes, layout) 
int tildes; 

struct wm_ layout 'layout; 

Description 

The wmlayout function fetches a description of the screen 
layout of a terminal under window management. Fildes is a 
file descriptor associated with the terminal's special file by a 
creat, dup, fcntl, or open system call; the association of fildes 
with a particular window is not used. Layout points to an 
area that is to receive the description. Before calling wmlayout, 
a program must set layout->maxwcount to indicate the 
number of window descriptions the area can accommodate; 
the constant WIVLMAX gives the number of windows 
currently permitted. The description consists of the following 
data structures: 

struct wm_layout { 

int cwi ndowi d ; 

short maxwcoun t ; 

sho r t wcoun t ; 

struct wm_l ayou tw[Z*A_MAX] ; 

}: 

struct wm_w layout { 

int w i ndowi d ; 

short pwindowid; 

short start row; 

sho r t s t a r t co I umn ; 

shor t d rows ; 

short dcolumns; 

short syncrow; 

short synccolumn; 

short v r ows ; 

short vco I umns ; 

short crow; 

short ccolumn; 

char reserved[6]: /•must be 0'/ 
I 
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Here are the meanings of the fields in a wmJayout structure: 



cwindowid 
maxwcount 

mount 
w 



The window ID of the active window. 

Number of window descriptions this structure has room for. 
Normally set to WNLMAX so as to get all of them. 

Number of windows currently on terminal. 

Array of individual window descriptions. 



Here are the meanings of the fields in a wm-w/ayout structure: 



windowid 
pwindowid 

startrow 
startcolumn 

drom 

dcolumns 

syncrow 
synccolumn 

vrows 
vcolumns 

crow 

ccolumn 

reserved 



The window ID. 

The physical window ID. Meant only for window management 
internal use. 

Starting physical row of the window {the tag line is on the row before). 

Starting physical column of the window. Currently this value is 
always 1. 

The number of displayed rows in the window. Note that the tag 
line is not counted in this value. 

The number of displayed columns in the window. Currently this 
value is always 80. 

Virtual display row that corresponds to the first row of the window. 

Virtual display column that corresponds to the first column of the 
window. Currently this value is always 1. 

Number of rows in virtual display. 

Number of columns in virtual display. Currently this value is 
always 80. 

The current cursor row number. 
The current cursor column number. 
Always zeros. 



Rows and columns are numbered from 1 
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A window ID is a positive integer that identifies the window 
associated with the file descriptor. The ID is passed to other 
window management library functions to identify the 
particular window being acted upon. The only way to get a 
valid window ID is from a window management library call; 
do not use a value obtained any other way. 

Currently, physical windows always start in column zero and 
physical windows and virtual displays are always 80 columns 
wide. 

wmlayout will fail if one or more of the following are true: 

Fildes is not an open file descriptor. [EBADF] 

The indicated file does not represent a terminal, or the 
terminal cannot support window 
management. [ENOTTY] 

The structure pointed to by w/ndowreq is 
invalid. [EINVAL] 

The window manager is not running on the 
terminal. [ENOENT] 

Files 

/usr/lib/libwm.a - window management library 
/dev/tty* 

Diagnostics 

wmlayout returns 0 if successful; otherwise, the function 
returns -1 and sets errno to indicate the error. 

See Also 

wm in Section 1 ; wmgetid, wmsetid, wmop. 
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Name 

wmop - window management operations 

Format 

#include <oa/wm.h> 

int wmop (tildes, windowreq, layout) 
int lil das ; 

struct wm_request 'windowreq: 
struct wm_layout 'layout; 

Description 

wmop manipulates windows on a terminal under window 
management. It is normally used by application programs. 
Fildes is a file descriptor associated with the terminal's 
special file by a creat, dup, fctntl, or open system call.; the 
association of fildes with a particular window is not used. 
Windowreg is a pointer to a structure that describes the 
operation. Layout is an optional pointer to a layout structure 
of the type used by wmlayout; if present, the structure is filled 
with the new description of the window. 

The request structure is defined as follows: 

struct wm_request { 

i n t reques t : 

Int w i ndow i d ; 

int ( 'not I f y ) ( ) 

short startrow; 

short startcol umn ; 

short d r ows ; 

shor t dco I umns ; 

short sync row; 

shor t syncco I umn ; 

short v rows ; 

short vco I umns ; 

short c r ow ; 

shor t ceo I umn ; 

} ; 
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Only two fields in the request structure are used by all 
operations: 

a Request specifies the operations desired. See the operation 
constants, described below. 

□ Windowid specifies a window, usually with a window ID 
returned by a previous wmop, wmlayout, or wmgetid. The only 
way to get a valid window ID is from a window 
management library call; do not use a value obtained any 
other way. If the operations do not include WIVLCREATE 
(create a new window), windowid is a window ID that 
specifies the single window to which the operations apply. 
If the operations do include WIVLCREATE, windowid must 
be either a window ID, indicating the window that yields 
space for the new window, or 0, a value with special 
meanings described under WIVLCREATE and WIVLSTART; 
the other operations apply to the new window. 

WIVLCREATE Create a new window. Other operations describe the new 

window's characteristics; if no other operations are specified 
with WIVLCREATE, the new window has the following 
characteristics: 

The new window occupies the bottom half of the 
window specified by windowid. If windowid is 0, the 
new window occupies the bottom half of the active 
window. 

The new window's virtual display is 29 lines long. 

The cursor is on the first line of the new window's 
virtual display, which is also the first line of the new 
window. 

The user is permitted to split the new window only if 
the old window permitted user splits. See WrVLSPLIT. 

WMJDESTROY Destroy the window. If the window is the top window, the 

destroyed window's rows go to the window below; 
otherwise the destroyed window's rows go to the window 
above. If the destroyed window was the active window, the 
window that gets the destroyed window's rows is activated. 
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WMJJSIZE 



WMJJRSIZE 



WMJJSTART 



WMJJRSTART 



WIVLVSIZE 



Change the window size. The operation can be modified by 
WIVLDRSIZE; this description assumes it is not. The 
window size, which does not include the window's tag line, 
can vary from 0 to 26. Drows specifies the new window size. 

If WMJJSIZE is specified with WfVLCREATE, drows 
specifies the new window's size. 

Modifies WMJJSIZE so the drows specifies an offset 
relative to the current value, rather than an absolute size. 
Drows can be negative. 

If WNLDSIZE and WIVLDRSIZE are specified with 
WfVLCREATE, drows specifies the new window's size 
relative to the size of the old window. Thus, in this case, 
drows must be negative. 

Set the starting row of the window (not the tag line, which 
is automatically on the row before). This operation may be 
modified by WfVLDRSTART; this description assumes it is 
not. Rows are numbered from 1, and a window can start 
on any row from 2 to 28. Startrow specifies the new 
starting row. 

If WMJJSTART is specified with WfVLCREATE and 
windowid is 0, startrow specifies the new window's 
starting position on the screen, without reference to an 
existing window. 

Modifies WfVLDSTART so the startrow specifies an offset 
relative to the current value, rather than an absolute 
starting row. Startrow can be negative. 

If WMJJSTART and WfVLDRSTART are specified with 
WM_CREATE, startrow must be non-negative; the new 
window starts startrow rows after the start of the old 
window. If startrow is 0, the new window takes the top 
portion of the old window's rows instead of the bottom. If 
startrow is positive, WMJJSIZE is ineffective: the size of 
the new window is dictated by the size of the old. 

Set the virtual window size to vrows long. The operations 
can be modified by WNLVRSIZE. In any case, the virtual 
display must be 1 to 28 rows long. 

If the virtual display is shortened past the cursor, the cursor 
must be moved to within the new virtual display end. If the 
WM_CURS0R operation is not specified at the same time, 
the terminal moves the cursor to the new last line of the 
virtual display. 



Library Functions 



3-243 



wmop 

WNLVRSIZE Modifies WM_VSIZE so that vrows is an offset to the 

present value. Vrows can be negative. 

WM_VSTART Synchronize the window and its virtual display by making 

virtual display row syncrow (numbered from 1 ) the first row 
on the window. This operation can be modified by 
WM_VRSTART. The window manager will modify a 
WM_VSTART operation as necessary to keep the window 
from extending past the bottom of the virtual display. If the 
cursor is visible, the terminal software will modify a 
WfVLVSTART operation as necessary to keep the cursor in 
the window. 

Modify WMJ/START so that syncrow is an offset to the 
present value. Syncrow can be negative. 

Make the window the active window. 

If the window is the active window, make another window 
the active window: if the designated window is the top 
window, the window below; otherwise, the window above. 

Position the cursor on row crow. 

Enable change of splitting permission. Used in conjunction 
with WM_NSPLIT. If WM_SPLIT is specified alone, the 
user can split the window as long as the terminal can 
handle another window. If WM_SPLIT and WM_NSPLIT are 
specified together, the SPLIT key is ineffective when the 
window is active. 

Disable window split. Always used in conjunction with 
WM_SPLIT. 

Notify is a notify procedure. Set notify to (int(*)())0 to 
disable an existing notify procedure. The calling process will 
be interrupted and notify will be called if any other process 
or the user changes the status of the window. Window 
status includes window size, location, and whether it is 
active; it does not include cursor location. 

Currently, all windows and displays must begin in column 0 
and be 80 columns wide. 



WM_VRSTART 

WM_SELECT 
WM_DESELECT 

WM_CURSOR 
WM_SPLIT 



WMJVSPLIT 



WM_NOTIFY 
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wmop fails if one or more of the following are true: 

Fildes is not an open file descriptor. [EBADF] 

The indicated file does not represent a terminal, or the 
terminal cannot support window 
management. [ENOTTY] 

The structure pointed to by windowreq is 
invalid. [EINVAL] 

The window manager is not running on the 
terminal. [ENOENT] 

Files 

/dev/tty* 

/usr/lib/libwm.a - window management library 

Diagnostics 

If the operations were successful, the window ID of the 
affected window (the new window if one was created) is 
returned. Otherwise, -1 is returned and errno is set to indicate 
the error. 

Cautions 

Use wmop conservatively and with extreme care. 
Indescriminate use by programs competing for window 
space can result in race conditions and screen image 
instability. 

The window manager and terminal software silently enforce 
basic consistency. A program must not make assumptions 
about what the window looks like after a successful wmop; 
instead, it must examine the new wmlayout structure to find 
out what actually happened. 

See Also 

wmgetid, wmlayout, wmsetid, terror to get file descriptor for 
terminal accessed with standard I/O package. 
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Name 

wmsetid, wmsetids - associate a file descriptor with a window 

Format 

#include <oa/wm.h> 

int wmsetid {f tides, windowid) 
int wi ndowi d\ 
int tildes: 

int wmsstids (tildes, windowid) 
int windowid; 
int tildes; 

Description 

The wmsetid and wmsetids functions change the window with 
which a file descriptor is associated. Fildes must be a file 
descriptor open to a terminal on which the window manager 
is running. Fildes becomes associated with the window (on 
the same terminal) indicated by windowid, which must be a 
window ID obtained from a previous wmgetid, wmlayout, or 
wmop call. 

If a program performs a wmsetid on an inherited file 
descriptor, all processes that have inherited and use the 
same file descriptor and the process they inherited it from 
are affected. By convention, 0 (equivalent to fileno(stdin)), 1 
(equivalent to (fileno(stdout)), and 2 (equivalent to 
fileno(stderr)) are inherited file descriptors. The following 
code closes and reopens them so that a wmsetid on them 
doesn't affect other processes. It should be executed before 
terminal input/output begins: 

t t y- t t yname ( 0 ) : 
c I ose ( 0 ) ; 
c I ose ( 1 ) ; 

open ( t t y , 0_RDWR) ; 
c lose( 2 ) : 
dup(O) ; 
dup(O) ; 
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Be sure to complete buffered terminal output before 
switching windows. See fclose if you use the standard 
input/output package. 

wmsetid and wmsetids are different only when executed by a 
process group leader. If the process group leader calls 
wmsetids and the specified window is not already a controlling 
window for another process group, the specified window 
becomes the process group's controlling window. (For more 
details on control windows, see termio and window, both in 
Section 6). wmsetid never changes the controlling window 
under any circumstances. 

wmsetid and wmsetids fail if one or more of the following are true: 
Fildes is not an open file descriptor. [EBADF] 

The indicated file does not represent a terminal, or the 
terminal cannot support window 
management. [ENOTTY] 

The structure pointed to by windowreq is 
invalid. [EINVAL] 

The window manager is not running on the 
terminal. [ENOENT] 

Files 

/dev/tty* 

/usr/lib/libwm.a - window management library 

Diagnostics 

A non-negative value indicates success: 0 if the file 
descriptor wasn't associated with a window before the call, 
the old window otherwise. On error, -1 is returned and errno 
is set. 

See Also 

wm in Section 1 ; wmop, wmlayout, wmgetid, ferror. 
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Permuted Index 

This index includes entries for all pages of all four volumes of 
this guide. The entries themselves are based on the one-line 
descriptions or titles found in the Name portion of each 
manual entry; the significant words (keywords) of these 
descriptions are listed alphabetically down the center of the 
index. 

The permuted index is a keyword-in-context index that has 
three columns. To use the index, read the center column to 
look up specific commands by name or by subject topics. 
Note that the entry may begin in the left column or wrap 
around and continue into the left column. A period (.) marks 
the end of the entry, and a slash (/) indicates where the entry 
is continued or truncated. The right column gives the manual 
entry under which the command or subject is described; 
following each manual entry name is the section number, in 
parentheses, in which that entry can be found. 



/lto!3: convert between 


3-byte integers and 


l3tol(3) 


long/ 




comparison, diff 3: 


3-way differential file 


diff3(1) 


between long integer/ 


a64l, 164a: convert 


a64l(3) 


/obtain and 


abandon exchanges. 


exchanges(2) 


fault. 


abort: generate an I0T 


abort(3) 


absolute value. 


abs: return integer 


abs(3) 


adb: 


absolute debugger 


adb(1) 


abs: return integer 


absolute value. 


abs(3) 


ceiling, remainder. 


absolute value/ /floor, 


floor(3) 


allow/prevent LP/ 


accept, reject: 


accept( 1) 


times of/ touch: update 


access and modification 


touch(1) 


times, utime: set file 


access and modification 


utime(Z) 


/ofCloseAIIFiles: 


Access BTOS files 


ofopenfile(3) 


accessibility of a/ 


access: determine 


access(Z) 


in a/ sputl, sgetl: 


access long integer data 


sputl(3) 
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sadp: disk 
common object file 
file systems for optimal 
locking: exclusive 
/endutent, utmpname: 
access: determine 
or disable process 
/manipulate connect 
process accounting, 
sin, cos, tan, asin, 
killall: kill all 
sag: system 
sal, sa2, sadc: system 
File Processor system 
sar: system 
SCCS file editing 
process data and system 

BTOS queue. quAdd: 
putenv: change or 
administer SCCS files, 
admin: create and 
alarm: set a process 
alarm clock. 



access profiler. 


sadp(1) 


access routines. Idfcn: 


ldfcn(4) 


access time, /copy 


dcopy(l) 


access to regions of a/ 


locking(2) 


access utmp file entry. 


getut(3) 


accessibility of a file. 


access(2) 


accounting, /enable 


acct<2) 


accounting records. 


fwtmp(l) 


acct: enable or disable 


acct(2) 


acos, atan, atan2:/ 


trig(3) 


active processes. 


killall(l) 


activity graph. 


sag(1) 


activity report package. 


sar(l) 


activity reporter. 


fpsard) 


activity reporter. 


sar(1) 


activity, /print current 


sact(l) 


activity, /report 


timexd) 


adb: absolute debugger 


adb(1) 


add a new entry to a 


quadd(3) 


add value to/ 


putenv(3) 


admin: create and 


admind) 


administer SCCS files. 


admin(l) 


alarm clock. 


alarm(2) 


alarm: set a process 


alarm(2) 
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for sendmail. 


aliases: aliases file 


aliases! 5) 


sendmail. aliases: 


aliases file for 


aliases(5) 


/ofDelete: 


allocate BTOS files. 


ofcreateO) 


data segment space 


allocation, /change 


brk(2) 


calloc: main memory 


allocator, /realloc, 


malloc(3) 


fast main memory 


allocator, /mallinfo: 


malloc(3) (fast 
version) 


accept, reject: 


allow/prevent LP/ 


accept( 1) 


brc, bcheckrc, rc, 


allrc, conrc: system/ 


brc(1) 


running process/ renice: 


alter priority of 


renice(l) 


sort: sort 


and/or merge files. 


sort(l) 


and link editor output. 


a.out: common assembler 


a.out(4) 


Processor number. 


apnum: print Application 


apnum(l) 


number, apnum: print 


Application Processor 


apnumd) 


console: control 


Application Processor/ 


consoled) 


/a process on a specific 


Application Processor. 


spawn(l) 


/a process on a specific 


Application Processor. 


spawn(3) 


/to commands and 


application programs. 


intro(l) 


code. exServeRq: 


appropriate a request 


exserverq(2) 


maintainer for portable/ 


ar: archive and library 


aril) 


format. 


ar: common archive file 


ar(4) 


arithmetic/ be: 


arbitrary-precision 


bc(1) 


maintainer for/ ar: 


archive and library 


ar(1) 


cpio: format of cpio 


archive 


cpio(4) 


ar: common 


archive file format. 


ar(4) 
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header of a member of an 


archive file, /archive 


IdahreadP) 


/convert object and 


archive files to common/ 


convert(l) 


Idahread: read the 


archive header of a/ 


IdahreadO) 


tar: tape file 


archiver. 


tar(1) 


maintainer for portable 


archives, /and library 


ar{1) 


cpio: copy file 


archives in and out. 


cpio(1) 


varargs: handle variable 


argument list. 


varargs(5) 


/output of a varargs 


argument list. 


vprintf{3) 


xargs: construct 


argument list(s) and/ 


xargs(1) 


/get option letter from 


argument vector. 


getopt(3) 


expr: evaluate 


arguments as an/ 


expr(1) 


echo: echo 


arguments. 


echo(l) 


be: arbitrary-precision 


arithmetic language. 


bc(1) 


expr: evaluate arguments 


as an expression. 


exprO) 




as: assembler. 


as(1) 


ascii: map of 


ASCII character set. 


ascii(5) 


hd: hexadecimal and 


ascii file dump. 


hd(1) 


character set. 


ascii: map of ASCII 


ascii(5) 


long integer and base-64 


ASCII string, /between 


a64l(3) 


atof: convert 


ASCII string to/ 


atof(3) 


date/ /localtime, 
gmtime. 


asctime, tzset: convert 


ctime(3) 


sin, cos, tan, 


asin, acos, atan, atan2:/ 


trig(3) 


help: 


ask for help. 


help(1) 
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editor/ a. out: common 


assembler and link 


a.out(4) 


as: 


assembler. 


as(1) 


assertion 


assert: verify program 


assert(3) 


assert: verify program 


assertion. 


assert(3) 


setbuf, setvbuf: 


assign buffering to a/ 


setbuf(3) 


wmsetid, wmsetids: 


associate a file/ 


wmsetid(3) 


commands at a later/ 


at, batch: execute 


at(1) 


cos, tan, asin, acos, 


atan, atan2: sin, 


trig(3) 


tan, asin, acos, atan, 


atan2: trigonometric/ 


trig(3) 


string to/ 


atof: convert ASCII 


atof(3) 


strtod, 


atof: convert string to/ 


strtod(3) 


integer, strtol, atol. 


atoi: convert string to 


strtol(3) 


string to/ strtol, 


atol, atoi: convert 


strtol{3) 


process, wait: 


await completion of 


wait(1) 


and processing/ 


awk: pattern scanning 


awk(1) 


request. quRemove: take 


back a BTOS queue 


quremovep) 


ungetc: push character 


back into input stream. 


ungetc(3) 


fine: fast incremental 


backup. 


fined ) 


recover files from a 


backup tape, free: 


freed ) 




banner: make posters. 


bannerd) 


modem capability data 


base, modemcap: smart 


modemcap(5) 


terminal capability data 


base, termcap: 


termcap(4) 


terminal capability data 


base, terminfo: 


terminfo(4) 
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between long integer and 

(visual) display editor 

portions of path names. 

at a later time, at, 
arithmetic language, 
system intialization/ brc, 
copy. 

cb: C program 

jO, jl, jn, yO, yl, yn: 

/install object files in 
fread, fwrite: 
bsearch: 

tfind, tdelete, twalk: 
manage 

bcopy: interactive 

sum: print checksum and 

sync: update the super 

df: report number of free 
disk 

conrc: system 
initialization/ 

spare allocation. 



base-64 ASCII string. 


a64l{3) 


/rnnuprt 




based on ex. 


vi(1) 


/screen-oriented 




basename, dirname: 


basename) 


deliver 


batch: execute commands 


at(1) 


be: arbitrary-precision 


bc(1) 


beheckre, rc, allrc, conrc: 


brc(1) 


bcopy: interactive block 


bcopy(t) 


copy. 




bdiff: big diff. 


bdiff (1) 


beautifier. 


cb(1) 


Bessel functions. 


bessel(3) 


bfs: big file scanner. 


bfs(1) 


binary directories. 


cpset(l) 


hinarv innut /nutni it 


fread(3) 


binary search a sorted 
table. 


bsearchO) 


binary search trees. 


tsearch(3) 


tsearch, 


block copy. 


bcopy(l) 


block count of a file 


sum(1) 


block. 


sync(1) 


blocks. 


df(1) 


brc, beheckre, rc, allrc. 


brc(1) 


brk, sbrk: change data 


brk(2) 


segment 
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compiler/interp 


bs: a 


bs(1) 


reter/ 






sorted table 


h^parrh' hinarv search a 


bsearch(3) 


/ofDIDit, 


RTflS riircrtnrv functions. 


ofdir(3) 


ofReadDirSector: 






ofWrite: Input/output on a 


BTOS file. ofRead, 


ofread(3) 


ofRename: rename a 


BTOS file. 


ofrename(3) 


ofSetFileStatus: 


BTOS File Status. 


ofstatus(3) 


of copy: copy to or from the 


BTOS file system. 


ofcopyll ) 


directories, ofls: list 


BTOS files and 


ofls(1) 


/ofDelete: Allocate 


BTOS files. 


ofcreate(3) 


ofed, ofvi: edit 


D I uo iiica. 


ofeditorsd) 


ofCloseAIIFiles: Access 


BTOS files. /ofCloseFile. 


ofopenfile(3) 


interpreter for interactive 


BTOS JCL. ofcli: 


ofcli(l) 


command line 




CENTIX kernel and copy 


BTOS. mkboot: reformat 


mkbootiD 



it to 

quAdd: add a new entry 
to a 

quReadKeyed: examine 



quRemove: take back a 
stdio: standard 

setbuf, setvbuf: assign 
mknod: 

swapshort, swaplong: 
translate 

swab: swap 



BTOS queue. 
BTOS queue. 



BTOS queue request, 
buffered input/output 



buffering to a stream 

build special file. 

byte orders to 
Motorola/Intel. 

bytes. 



quadd(3) 

quread(3) 

quremove(3) 
stdio(3) 

setbuf(3) 
mknod(l) 
swapshort(3) 

swab(3) 
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cc: 

cflow: generate 
cpp: the 
cb: 

lint: a 

cxref: generate 
ctrace: 

dc: desk 
cal.print 
service, 
cu: 

data returned by stat 
system 

malloc, free, realloc, 

fast/ malloc, free, 
realloc, 

intro: introduction to 
system 

link and unlink system 

to an LP line printer. Ip,. 

modemcap: smart modem 
termcap: terminal 
terinfo: terminal 
disks, dsk: Winchester, 
(variant of ex for 



C compiler. 

C flowgraph. 

C language preprocessor. 

C program beautifier. 

C program checker. 

C program cross 
reference. 

C program debugger, 
cal: print calendar, 
calculator, 
calendar. 

calendar: reminder 

call another computer 
system. 

call, stat: 

calloc: main memory 
allocator. 

calloc, mallopt, mallinfo: 

calls and error number. 

calls, link, unlink: 
exercise 

cancel: send/cancel 
requests 

capability data base, 
capability data base, 
capability data base, 
cartridge, and floppy 
casual users), /editor 



cc(1) 

cflow(l) 

cpp(1) 

cb(1) 

lint(l) 

cxref (1) 

ctrace(l) 
cal(l) 

dc(i) 

cal(l) 

calendar(l) 

cu(1) 

stat(5) 

malloc(3) 

malloc(3) (fast 
version) 

intro(2) 

linkd) 

lp(D 

modemcap{5) 

termcap(4) 

terminfo(4) 

dsk(6) 

edit(l) 
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files. 

beautifier. 
directory. 

commentary of an SCCS 
delta. 

ceiling, remainder,/ floor, 
/ceil, fmod, fabs: floor, 

BTOS. mkboot: reformat 

uuname: CENTIX system 
to 

uucp, uulog, uuname: 

print name of current 
get name of current 
command execution, uux: 

uuto, uupick: public 

flowgraph. 

delta: make a delta 

of running process by 

pipe: create an 
interprocess 

terminal's local RS-232 

stream, ungetc: push 



cat: concatenate and 
print 

cb: C program 
cc: C compiler, 
cd: change working 
cdc: change the delta 

ceil, fmod, fabs: floor, 

ceiling, remainder, 
absolute/ 

CENTIX kernel and copy 
it to 

CENTIX system copy. 

CENTIX system to 
CENTIX/ 

CENTIX system, uname: 

CENTIX system, uname: 

CENTIX-to-CENTlX 
system 

CENTIX-to-CENTlX 
system file/ 

cflow: generate C 

(change) to an SCCS 
file. 

changing nice, /priority 
channel. 

channels, tp: controlling 
character back into input 



catd) 

cb(1) 
cc(1) 
cd(1) 
cdc(1) 

floor(3) 
floor{3) 

mkbootO) 

uucpd) 

uucp(1) 

unamed) 
uname(2) 
uuxd) 

uutod) 

cfiowd) 
delta(l) 

rsrticed) 
pipe(2) 

tp(6) 
ungetcO) 
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user, cuserid: get 


character login name of 
the 


cuserid(3) 


petchar faetc aetw oet 

yutviiwi , JJvivf y Will i u G L 


uidracier or woru trom a/ 


getc(3) 


/putchar, fputc, putw: 
put 


character or word on a 
stream. 


putc(3) 


ascii: map of ASCII 


character set. 


ascii(5) 


— tolower, toascii: 
translate 


characters. / toupper. 


conv(3) 


iscntrl, isascii: classify 


Pfl£)r9f*t Ore /ionrint 

uiiaidLicis. /isprim, 
isgraph. 


ctype(3) 


tr: translate 


Lnaraciers. 


tr(1) 


directory. 


chdir: change working 


chdir(2) 


/dfsck: file system 
consistency 


check and interactive 
repair. 


fsck(1) 


lint: a C program 


checker. 


lint(1) 


grpck: password/group 
file 


checkers, pwck, 


pwck(1) 


copy file systems with 
label 


checking, volcopy, labelit: 


volcopy (1) 


systems processed by 
fsck. 


checklist: list of file 


checklist(4) 


file, sum: print 


checksum and block 

rnnnt nf a 
luuiii ui a 


sum(1) 


chown, 


rhnrn* rhnnno nuunor nr 
i*nyijj. uiianyc uwiicf ui 

group 


chown(1) 


times: get process and 


child process times. 


times(Z) 


terminate, wait: wait for 


child process to stop or 


wait(2) 




chmod: change mode. 


chmod(l) 


file. 


chmod: change mode of 


chmod{2) 
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of a file. 

group. 

directory. 

for a command. 

isgraph, iscntrl, isascii: 

uuclean: uucp spool 
directory 

screen. 

clri: 

clear: 

status./ terror, feof, 

exRespond: send a 
message to a 

set a process alarm 

cron: 

used. 

Idclose, Idaclose: 

close: 
descriptor, 
fclose, fflush: 

appropriate a request 

line-feeds. 

deltas. 

comb: 



chown: change owner 
and group 

chown, chgrp: change 
owner or 

chroot: change root 

chroot: change root 
directory 

classify characters, 
/isprint, 

clean-up. 

clear: clear terminal 

clear i-node. 

clear terminal screen. 

clearerr, fileno: stream 

client. 

clock, alarm: 

clock daemon. 

clock: report CPU time 
used. 

close a common object 
file. 

close a file descriptor, 
close: close a file 
close or flush a stream, 
clri: clear i-node. 
cmp: compare two files 
code. exServeRq: 
col: filter reverse 
comb: combine SCCS 
combine SCCS deltas. 



chown(2) 

chown(l) 

chroot(2) 
chroot! 1) 

ctype(3) 

uuclean(l) 

clear(l) 
clri(l) 
clear) 1) 
ferror(3) 
exrespond(2) 

alarm(2) 

cron(l) 

clock(3) 

ldclose(3) 

close(2) 

close(2) 

fclose(3) 

drill ) 

cmp(t) 

exserverq(2) 

cold) 

comb(1) 

comb(1) 
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common to two sorted 
files. 


comm: select or reject 
lines 


comm(1) 


nice: run a 


command at low priority. 


nice(l) 


change root directory for a 


command, chroot: 


chrootO) 


env: set environment for 


command execution. 


env(1) 


uux: remote system 


command execution. 


uux(1) 


quits, nohup: run a 


command immune to 
hangups and 


nohup(l) 


interactive BTOS JCL. 
ofcli: 


command line interpreter 
for 


ofcli(l) 


getyopt: parse 


command options. 


getopt(l) 


locate executable file for 


command, path: 


path(l) 


shell, the standard/ 
restricted 


command programming 
language. 


sh(1) 


data and/ timex: time a 


command; report process 


timex(l) 


system: issue a shell 


command. 


system(3) 


test: condition evaluation 


command. 


test(1} 


time: time a 


command. 


timed) 


nmiimont liot/o\ 3nH 
diyUINcNl lldl\o^ dim 

execute 


command, xargs: 
construct 


xargsd) 


intro: introduction to 


commands and 
applicaton/ 


introd) 


at, batch: execute 


commands at a later/ 


at(1) 


install: install 


commands. 


install(l) 


cdc: change the delta 


commentary of an SCCS 
delta. 


cdc(1) 


ar: 


common archive file 
format. 


ar(4) 
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editor output, a. out: 

and archive files to 
routines. Idfcn: 

Idopen, Idaopen: open a 
/line number entries of a 

/Idaclose: close a 
read the file header of a 

entries of a section of a 

file header of a 

/entries of a section of a 

/section header of a 

an indexed/name section 
of a 

of a symbol table entry 
of a 

symbol table entry of a 

seek to the symbol table 
of a 

line number entries in a 

nm: print name list of 

relocation information for 
a 

scnhdr: section header 
for a 



common assembler and 
link 

common formats, /object 

common object file 
access 

common object file for/ 

common object file 
function. 

common object file. 

common object file. 
Idfhread: 

common object file, 
/number 

common object file, 
/seek to 

common object file. 

common object file. 

common object file, 
/seek to 

common object file, /the 
index 

common object file, 
/indexed 

common object file. 
Idtbseek: 

common object file, 
linenum: 

common object file. 

common object file, 
reloc: 

common object file. 



a.out(4) 

convert! 1) 
ldfcn(4) 

IdopenO) 
IdlreadO) 

ldclose(3) 
IdfhreadO) 

IdlseekO) 

ldohseek(3) 

ldrseek(3) 

IdshreadO) 

ldsseek(3) 

idtbindex(3) 

ldtbread(3) 

IdtbseekO) 

linenum(4) 

nm(1) 
reloc(4) 

scnhdr(4) 
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line number information 
from a 


common object file, /and 


strip! 1) 


retrieve symbol name for 


common object file 
symbol/ 


Idgetnamel 


table format, syms: 


common object file 
symbol 


syms(4) 


filehdr: file header for 


common object files. 


filehdr(4) 


Id. link editor for 


common object files. 


ld(1) 


size: print section sizes of 


common object files. 


sized ) 


comm: select or reject 
lines 


common to two sorted 
files. 


comm(1) 


ipcs: report inter-process 


communication facilities/ 


ipcs(1) 


stdipc: standard 
interprocess 


communication package 
(ftok). 


stdipc(3) 


diff: differential file 


comparator. 


diff(1) 


cmp: 


compare two files. 


ptrinf 1 \ 
MI1|I\ 1 / 


SCCS file, sccsdiff: 


compare two versions of 
an 


sccsdiff (1) 


diff3: 3-way differential 
rue 


comparison. 


diff3(1) 


dircmp: directory 


comparison. 


dircmpd) 


expression, regemp, 
regex: 


compile and execute 
regular 


regcmp(3) 


regexp: regular 
expression 


compile and match 
routines. 


regexp(5) 


regemp: regular 
expression 


compile. 


regcmp(l) 


term: format of 


compiled term file. 


term (4) 

IWI III \T/ 


cc: C 


compiler. 


ccd) 


tic: terminfo 


compiler. 


tic(l) 


yacc: yet another 


compiler-compiler. 


yaccd) 
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modest-sized/ 


compiler/interpreter for 


bs{1) 


bs: 3 






erf, erfc: error function and 


complementary error 
Tunciion. 


erf(3) 


wait: await 


completion of process. 


wait! 1 ) 


pack, peat, unpack: 


compress and expand 


pack(1) 


files. 




table entry of a/ 


compute the index of a 


ldtbindex(3) 


Idtbindex. 


cumhnl 
syiiiuui 




cu: call another 


computer system. 


CUID 


cat: 


concatenate and print 
files. 


cat(1) 


test: 


condition evaluation 


test{1) 


command. 




system. Ipadmin: 


contigure the Lr spooling 


InaHminl 1 1 

IJJaUIIIHll I 1 


fwtmp, wtmpfix: 


connect accounting 


fwtmp(l) 


manipulate 


records. 




an out-going terminal 


connection, dial: 


dial(3) 


line 






brc, beheckre, rc, allrc, 




brc(1) 


initialization/ 




fsck, dfsck: file system 


consistency check and/ 


fsck(l) 


terminal. 


console: console 


console(6) 


Application rlUtBooUl / 


console: control 


console! 1) 


console: 


ransolfl terminal 


console(6) 


matb: math functions 


constants. 


math(S) 


and 






mkts: 


rnnctmrt a file SVStem 


mkfs(1) 


execute command, xargs: 


rnrrctruct aroument 


xargsd) 


list(s) and 




Is: list 


contents of directory. 


ls(1) 


csplit: 


context split. 


csplit(l) 


Processor/ console: 


control Application 


consoled) 



1192192 



Index- 16 



ioctl: 


control device. 


ioctl(2) 


fcntl: file 


control. 


fcntl(2) 


init, icode, telinit: 
process 


control initialization. 


init(1) 


msgctl: message 


control operations. 


msgctl(2) 


semctl: semaphore 


control operations 


semctl(2) 


shmctl: shared memory 


control operations. 


shmctl(2) 


fcntl: file 


control options. 


fcntl(5) 


uucp status inquiry and job 


control, uustat: 


uustat(l) 


up* uorcinn 


control. 


vc(1) 


interface, tty: 


controlling terminal 


tty(G) 


RS-232 channels, tp: 


controlling terminal's 
local 


tp(6) 


terminals, term: 


conventional names for 


term(S) 


units: 


conversion program. 


UIIHSl i / 


dd: 


convert and copy a file. 


dd(1) 


floating-point number, 
atof: 


convert ASCII string to 


atof(3) 


integers and/ l3tol, ltol3: 


convert between 3-byte 


l3tol(3) 


and base-64 ASCII/ 
a64l, 164a: 


convert between long 
integer 


a64l(3) 


and archive files to/ 


convert: convert object 


convnrtd ) 

fwUIIVDI l\ 1 / 


/gmtime, asctime, tzset: 


convert date and time to/ 


ctime(3) 


to string, ecvt, fcvt, gcvt 


convert floating-point 
nubmner 


ecvt(3) 


scanf, fscanf, sscanf: 


convert formatted input. 


scanf(3) 


archive files/ convert: 


convert object and 


convert! 1) 


strtod, atof: 


convert string to/ 


strtod(3) 



Index- 17 



strtol, atol, atoi: 


convert string to integer. 


strtol(3) 


dd: convert and 


copy a file 


dd(1) 


bcopy: interactive block 


copy 


n/^nniif 1 1 

ocopy\ I / 


cpio: 


copy file archives in and 


cpio(1) 


out. 




access time, dcopy: 


copy file systems for 


dcopyd) 


optimal 




checking,, volcopy, 


copy file systems with 


volcopy(l) 


Inknlit- 

laoeiit. 


label 




reformat CENTIX kernel 


copy it to biuo. 


mkhnntll) 


and 


[TiKDuUl. 




cp, In, mv: 


Copy, HnK or muvc niea. 


cd(1) 


system, ofcopy. 


copy to or from the 


of copy d) 


d I Uo file 




system to CENTIX 


copy, /uuname: CENTIX 


uucp(1) 


system 






system-to- 


copy, /uupick: public 


uutod) 


computer system file 


computer 




tile. 


rnrp* fnrmat of corfi 


core(4) 




image 




core: format of 


rnrp itnane filfi 


core(4) 


mem, kmem: 


rnrp mpmnrv 


mem(6) 


atan2. trigonometric/ 


AAA IaA AA|rt IP AC 

cos, ion, asin, dcus, 


trig(3) 


sin, 


stan, 




functions, sinh, 


rnch tanh* hvnprhnlic 


sinh(3) 


sum: print checksum and 


count of a file. 


sum(1 ) 


block 






wc: word 


count. 


wed) 


files. 


rn In mv cody link or 


cpd) 




move 




cpio: format of 


cpio archive. 


cpio(4) 


and out. 


cpio: copy file archives in 


cpiod) 


archive. 


cpio: format of cpio 


cpio(4) 
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preprocessor. 


cpp: the C language 


cpp(1) 


binary directories. 


cpset: install object files in 


cpset(l) 


rlnrlf* rpnnrt 


uru time used. 


clock(3) 


rewrite an existing one. 


creat: create a new file or 


creat(2) 


file, tmpnam, tempnam: 


create a name for a 
temporary 


tmpnam(3) 


an pyi^tinn nnp rroat* 
ai i caiolii ly ui its. li cai. 


create a new file or 
rewrite 


creat(2) 


fork: 


create a new process. 


fork{2) 


impTiie, 


create a temporary file. 


tmpfileO) 


channel, pipe: 


create an interprocess 


pipe(2) 


files, admin: 


create and administer 
oUUo 


admin(l) 


fdirol rrnn* 


create file system 
partition 


crup(1) 


umask: set and get file 


creation mask. 


umask(2) 




cron: clock daemon. 


cron(1) 


TUB. 


crontab user crontab 


crontab(l) 


crontab user 


crontab file. 


crontab! 1) 


cxref: generate C 

nrnnram 
pi uui mil 


cross reference. 


cxref (1) 


OOtimizatian narkanp 
curses: 


on i screen nanonng anu 


curses(3) 


partition (slice). 


crup: create file system 


crup(1) 


generate uto encryption. 


crypt, setkey, encrypt: 


crypt(3) 




csplit: context split. 


csplit(l) 


terminal. 


ct: spawn getty to a 
remote 


ct(1) 


for terminal. 


ctermid: generate file 
name 


ctermid(3) 


asctime, tzset: convert 
date/ 


ctime, locaitime, gmtime, 


ctime{3) 
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debugger. 


ctrace: C program 


ctrace(l) 


system. 


cu: call another computer 


cu(1) 


uname: get name of 


current CENTIX system 


uname(2) 


uname: get name of 


current CENTIX system 


uname(2) 


artlv/itu cart" nnnt 


nirrcnt SCCS file editinn 


sact(1) 


slot in the utmp file of the 


current user, /find the 


ttyslot(3) 


getcwd: get path-name of 


current working 
directory. 


getcwd(3) 


and optimization package. 


curses: CRT screen 
handling 


curses(3) 


name of the user. 


cuserid: get character 
login 


cuserid(3) 


of each line of a file. 


cut: cut out selected 
fields 


cut(1) 


oarh lino nf a filn nit* 


rut nut iplprtpd fields of 


cut(1) 


LlubS IcIcTgIIUc. 


rvrof* npnpratp Ci 

LAlCl. yCMCIaLC Lr 

program 


cxref(l) 


trUiiiiiidiiUf (cjjuii (jiuucoo 


riata and svstpm/ /time a 


timexd) 


smart modem capability 


data base, modemcap: 


modemcap! 


termcap: terminal 
capability 


data base. 


termcap(4) 


terminfo: terminal 

ranahilitu 
Ld(JdUiuiy 


data base. 


terminfo(4) 


/cnoti* arpocc Innn 
/ oycii. dLUcoo lUiiy 

integer 


data in a 

uaia ill a 

machine-independent 


sputl(3) 


lock process, text, or 


data in memory, plock: 




prof: display profile 


data. 


prof(l) 


call, stat: 


data are turned by stat 
system 


stat(5) 
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brk, sbrk: change 


data segment space 
allocation. 


brk(2) 


types: primitive system 


data types. 


types(5) 


join: relational 


database operator. 


join(l) 


tput: query terminfo 


database. 


tput(1) 


/asctime, tzset: convert 


date and time to string. 


ctime(3) 


date: print and set the 


date. 


date(l) 


date. 


date: print and set the 


date(l) 




dc: desk calculator. 


dc(1) 


optimal access time. 


dcopy: copy file systems 
for 


dcopy (1) 


file. 


dd: convert and copy a 


dd(1) 


adb: absolute 


debugger. 


adbd) 


ctrace: C program 


debugger. 


ctraced) 


fsdb: file system 


debugger. 


fsdb(l) 


sdb: symbolic 


debugger. 


sdb(1) 


names, basename, 
dirname: 


deliver portions of path 


basename(l) 


file, tail: 


deliver the last part of a 


tail(l) 


delta commentary of an 

sees 


delta, ede: change the 


cdc(1) 


file, delta: make a 


delta (change) to an 
SCCS 


delta) 1) 


delta, ede: change the 


delta commentary of an 
SCCS 


cdc(1) 


rmdel: remove a 


delta from an SCCS file. 


rmdel(l) 


to an SCCS file. 


delta: make a delta 
(change) 


delta(l) 


comb: combine SCCS 


deltas. 


comb(1) 


cron: clock 


demon. 


cron(l) 
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mesg: permit or 


deny messages. 


mesg(l) 


close: close a file 


descriptor. 


closetf) 


dup: duplicate an open file 


descriptor. 


dup(2) 


/wmsetids: associate a 
file 


descriptor with a 
window. 


wmsetid(3 


dc: 


desk calculator. 


dc(1) 


file, access: 


determine accessibility of 
a 


access(2) 


file: 


determine file type. 


file(l) 


for finite width output 


device, /fold long lines 


fold(1) 


master: master 


device information table. 


master(4) 


ioctl: control 


device. 


ioctl(2) 


devnm: 


device name. 


devnm(l) 




dvnm: device name. 


devnm(l) 


blocks. 


df: report number of free 
disk 


iiifil 

OIUJ 


check and interactive/ 
fsck. 


dfsck: file system 
consistency 


tSCKl 1 J 


terminal line connection. 


dial: establish an 
out-going 


dial(3) 


bdiff: big 


diff. 


bdiff(l) 


comparator. 


diff: differential file 


diff(1) 


comparison. 


diff3: 3-way differential 
file 


diff 3(1) 


sdiff: side-by-side 


difference program. 


sdiffd) 


diff: 


ditterential tile 
comparator. 


Din\ i f 


diff3: 3-way 


differential file 
comparison. 


OUT J I 1 ) 


in large files and/ pilf. 


dio: performance 
improvement 


pilf(5) 


directories. 


dir: format of 


dir(4) 
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comparison. 


dircmp: directory 


dircmp(l) 


improvement in large 
files and 


direct I/O. /dio: 
performance 


pilf(5) 


install object files in 
binary 


directories, cpset: 


cpsetd) 


dir: format of 


directories. 


dir(4) 


ofls: list BTOS files and 


directories. 


ofls(l) 


rm, rmdir: remove files or 


directories. 


rm(1) 


cd: change working 


directory. 


cd(1) 


chdir: change working 


directory. 


chdir(2) 


chroot: change root 


directory. 


chroot(2) 


uuclean: uucp spool 


directory ciean-up. 


uuclean(l) 


dircmp: 


directory comparison. 


dircmp(1) 


unlink: remove 


directory entry. 


unlink(2) 


chroot: change root 


directory for a command. 


chroot(l) 


/make a lost + found 


directory for fsck. 


mklost+foundd) 


.inin!. .in in' o » 

ofDIDir, ofHeadDirSector: 
BTOS 


directory functions. 
ofCrDir, 


ofdir(3) 


path-name of current 
working 


directory, getcwd: get 


getcwd(3) 


Is: list contents of 


directory. 


Ml) 


mkdir: make a 


directory. 


mkdird) 


muHir* mnt/o a 
itivuii. iiiuvc a 


directory. 


mvdir(l) 


pwd: working 


directory name. 


pwd{1) 


ordinary file, mknod: 
make a 


directory, or a special or 


mknod(2) 
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path names, basename, 

printers, enable, 

acct: enable or 

type, modes, speed, and 
line 

sadp: 

df: report number of free 

update: provide 

du: summarize 

cartridge, and floppy 

mount, umount: mount 
and 

vi: screen-oriented 
(visual) 

prof: 

hypot: Euclidean 

/lcong48: generate 
uniformly 

whodo: who is 

/atof: convert string to 

tdl: RS-232 terminal 

nrand48, mrand48, 
jrand48,/ 

cartridge, and floppy/ 
usage. 

an object file. 



dirname: deliver portions 
of 

disable: enable/disable 
LP 

disable process 
accounting. 

discipline, /set terminal 



disk access profiler, 
disk blocks, 
disk synchronization, 
disk usage. 

disks, dsk: Winchester, 
dismount file system. 

display editor based on ex. 

display profile data. 

distance function. 

distributed 
pseudo-random/ 

doing what. 

double-precision number. 

download. 

drand48, erand48, 
Irand48. 

dsk: Winchester, 

du: summarize disk 

dump: dump selected 
parts of 



basename(l) 

enabled) 

acct(2) 

getty(l) 

sadpd) 
df(1) 
updated ) 
du(1) 
dsk{6) 
mount( 1) 

vid) 

profd) 

hypot(3) 

drand48(3) 

whodod) 
strtod(3) 
tdl(1) 

drand48(3) 

dsk(6) 

du(1) 

dumpd) 
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hd: hexadecimal and ascii 
fib 

flic 


dump. 


hd(1) 


UU. ULldl 


dump. 


OOll) 


nniont tita Humrv 
UUJcLl INC. UUIIip. 


oump seiecien pans ot an 


ftnmn/1 V 


Hpcrnntnr 


uup. uupiicaie an open we 


dupU) 


rlpcrrintnr Hi in* 

UBotfl I|JIUI . UUp. 


Hlinlio^ta art nfian Til a 

uupiiLaie an open rue 


aupuj 


orhn* 


echo arguments. 


ecno(i) 




echo: echo arguments. 


echo(l) 


floatinQ-point number to/ 


ecvt, fcvt, gcvt: convert 


ecvt(J) 




ed, red: text editor. 


edU) 


program, eno, eiexi. 


edata: last locations in 


end (J) 


OIcO, 0TV1. 


eon d i uo rues. 


oread) 


ofed, ofvi: 


edit BTOS files. 


ofvi(1) 


(variant of ex for/ 


edit: text editor 


edit(1) 


sact: print current SCCS 
filp 

Tile 


editing activity. 


sact(l) 


/(visual/ Qispiay 


editor based on ex. 


VlU) 


pri rpH* tpvt 


editor. 


ed(l) 


ex: text 


editor. 


ex(1) 


files. Id: link 


editor for common object 


ld(1) 


common assembler and 

link 


editor output, a.out: 


a.out(4) 


cpH- ctrpam 

OCU- Oil Col II 


editor. 


seau) 


for casual/ edit: text 


editor (variant of ex 


edit(1) 


/user, real group, and 


effective group IDs. 


getuid(2) 


and/ /getegid: get read 
user. 


effective user, real 
group. 


getuid(2) 


split FORTRAN, ratfor, or 


efl files, fsplit: 


fsplit(l) 
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for a pattern, grep, 

enable/disable LP 
printers. 

accounting, acct: 
enable, disable: 

encryption, crypt, setkey, 

setkey, encrypt: generate 
DES 

locations in program. 

getgrgid, getgrnam, 
setgrent, 

getpwuid, getpwnam, 
setpwent, 

utmp/ /pututline, 
setutent, 

nlist: get 

file, linenum: line number 

file/ /manipulate line 
number 

common/ /seek to line 
number 

/Idnrseek: seek to 
relocation 

utmp,wtmp: utmp and 
wtmp 

fgetgrent: get group file 

fgetwent: get password 
file 



egrep, fgrep: search a file 
enable, disable: 

enable or disable process 

enable/disable LP 
printers 

encrypt: generate DES 
encryption, crypt, 

end, etext, edata: last 

endgrent, fgetgrent: get 
group/ 

endpwent, fgetpwent: 

get/ 

endutent, utmpname: 
access 

entries from name list. 

entries in a common 
object 

entries of a common 
object 

entries of a section of a 

entries of a section of a/ 

entry formats. 

entry, /setgrent, 
endgrent, 

entry, /setpwent, 
endpwent. 



grep(l) 
enable(l) 

acct(2) 
enable(l) 

crypt(3) 
crypt(3) 

end(3) 
getgrent(3) 

getpwent(3) 

getut(3) 

nlist(3) 
linenum(4) 

ldlread(3) 

ldlseek(3) 

ldrseek(3) 

utmp(4) 

getgrent{3) 

getpwent(3) 
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utmpname: access utmp 
file 

object file symbol table 



/the index of a symbol 
table 

/read an indexed symbol 
table 

putpwent: write 
password file 

quAdd: add a new 

unlink: remove directory 

command execution. 



profile: setting up an 

environ: user 
execution, env: set 

getenv: return value for 

putenv: change or add 
value to 

inteface, and terminal 
mrand48, jrand48,/ 



complementary error 
function. 

complementary error/ 
erf, 

system error/ perror, 



entry, /setutent, 
endutent, 

entry, /symbol name for 
common 

entry of a common 
object file. 

entry of a common 
object file. 

entry. 



entry to a BTOS queue, 
entry. 

env: set environment for 

environ: user 
environment. 

environment at login 
time. 

environment. 

environment for 
command 

environment name, 
environment. 

environment, /terminal 

erand48, Irand48, 
nrand48, 

erf, erf c: error function and 

erfc: error function and 

errno, sys errlist, 

sys nerr: 



getut(3) 

ldgetname(3) 

IdtbindexO) 

IdtbreadO) 

putpwent{3) 

quadd(3) 
unlink(2) 
env(1) 
environ(5) 

profile(4) 

environ(5) 
env(1) 

getenv(3) 
putenv(3) 

tset(1) 
drand48(3) 

erf(3) 

erf{3) 

perror(3) 
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complementary/ erf, erf:: 

function and 
complementary 

sys errlist, sys nerr: 

system 

to system calls and 
matherr: 

hashcheck: find spelling 
terminal line/ dial: 
setmnt: 

in program, end: 
hypot: 

expression, expr: 

test: condition 

/text editor (variant of 

display editor based on 

obtain/ exQueryDfltResp 
Exch, 

exWait, exCheck: 

quReadNext, 
quReadKeyed: 

wait for the response, 
obtain and abandon 
message queue. exWait, 



error function and 

error function, /erfc: error 

error messages, /errno, 

error numbers, 
/introduction 

error-handling function. 

errors, /hashmake, spellin, 

establish an out-going 

establish mount table. 

etext, edata: last locations 

Euclidean distance 
function. 

evaluate arguments as an 

evaluation command. 

ex for casual users). 

ex: text editor. 

ex. /screen-oriented 
(visual) 

exAllocExch, 
exDeallocExch: 

examine an ICC message 
queue. 

examine BTOS queue. 

exCall: Send a request 
and 

exchanges. 
/exDeallocExch: 

exCheck: examine an ICC 



erf(3) 
erf(3) 

perror(3) 

intro(2) 

matherr(3) 

spell(l) 

dial(3) 

setmnt(1) 

end(3) 

hypot(3) 

expr(1) 

test(1) 

edit(1) 

ex(1) 

vid) 

exchanges(2) 

exwait(2) 

quread(3) 

excall(2) 

exchanges(2) 

exwait(2) 
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a file, locking: 


exclusive access to 
regions of 


locking(2) 


abandon/ /exAllocExch, 


exOeallocExch: obtain and 


exchanges(2 


execlp, execvp: execute a/ 


execl, execv, execle, 
execve. 


exec(2) 


execvp: execute/ execl, 
execv, 


execle, execve, execlp. 


exec(2) 


execl, execv, execle, 
execve, 


execlp, execvp: execute a/ 


exec(2) 


path: locate 


executable file for 
command. 


pathd) 


execve, execlp, execvp: 


execute a file, /execle. 


exec(2) 


specific Application/ 
spawn: 


execute a process on a 


spawn( 1) 


specific/ spawnlp, 
spawnvp: 


execute a process on a 


spawn(3) 


construct argument 
list(s) and 


execute command, xargs: 


xargs(l) 


regex: compile and 


execute regular/ regcmp, 


regcmp(3) 


set environment for 
command 


execution, env: 


env(1) 


sleep: suspend 


execution for an interval. 




sleep: suspend 


execution for interval. 


statin (3) 


monitor: prepare 


execution profile. 


monitor! 3) 


spawnsrv: service spawn 


execution requests. 


spawnsrvf 1) 


profil: 


execution time profile. 


profil(2) 


uux: remote system 
command 


execution. 


uux(1) 


execvp: execute a/ execl, 


execv, execle, execve, 
execlp. 


exec(2) 


execute/ execl, execv, 
execle. 


execve, execlp, execvp: 


exec(2) 


/execv, execle, execve, 
execlp. 


execvp: execute a file. 


exec{2) 



system calls, link, unlink: 
a new file or rewrite an 
process, 
exit, 

exponential, logarithm,/ 

peat, unpack: compress 
and 

exp, tog, loglO, pow, sqrt: 
expression. 

routines, regexp: regular 

regemp: regular 

expr: evaluate arguments 
as an 

compile and execute 
regular 

exAllocExch, 
exDeallocExch:/ 

server, 
client. 

exCnxSendOnDealloc: 
make/ 

request code. 

ICC message queue. 

remainder,/ floor, ceil, 
fmod, 

factor: 
true, 



exercise link and unlink 

existing one. creat: create 

exit, exit: terminate 

exit: terminate process. 

exp, log, log 10, pow, 
sqrt: 

expand files, pack, 

exponential, logarithm, 
power,/ 

expr: evaluate arguments 
as an 

expression compile and 
match 

expression compile, 
expression. 

expression, regemp, regex: 

exQueryDf ItRespExch, 

exRequest: Send a 
message to a 

exRespond: send a 
message to a 

exSendOnDealloc, 

exServeRq: appropriate a 

exWait, exCheck: examine 
an 

fabs: floor, ceiling, 

factor a number 
factor: factor a number, 
false: provide truth values. 



Iink(1) 

creat(Z) 

exit(2) 

exit(2) 

exp(3) 

pack(1) 

exp(3) 

expr(1) 

regexp(5) 

regempd) 
expr(1) 

regcmp(3) 

exchanges(2) 

exrequest(2) 

exrespond(2) 

exfinal(2) 

exserverq(2) 
exwait(2) 

floor(3) 

factor! 1) 
factor! 1) 
trued) 
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data in a 

machine-independent 
fine: 

/calloc, mallopt, mallinfo: 

abort: generate an I0T 
a stream. 



floating-point number/ 
ecvt, 

fopen, freopen, 
status inquiries, ferror, 

fileno: stream status/ 

statistics for a file 
system. 

stream, fclose, 

word from a/ getc, 
getchar, 

getgrnam, setgrent, 
endgrent, 

/getpwnam, setpwent, 
endpwent, 

stream, gets. 

pattern, grep, egrep, 

times, utime: set 

Idfcn: common object 
determine accessibility of 



fashion., /access long 
integer 

fast incremental backup. 

fast main memory 
allocator. 

fault. 

fclose, fflush: close or 
flush 

fcntl: file control, 
fcntl: file control options, 
fevt, gcvt: convert 

fdopen: open a stream. 

feof, clearerr, fileno: 
stream 

ferror, feof, clearerr, 
ff: list file names and 

fflush: close or flush a 

fgetc, getw: get character 
or 

fgetgrent: get group file/ 

fgetpwent: get password 
file/ 

fgets: get a string from a 

fgrep: search a file for a 

file access and 
modification 

file access routines. 

file, access: 



sputl(3) 
finc(l) 

malloc(3) (fast 
version) 

abort(3) 

fclose(3) 

fcntl(2) 
fcntl{5) 
ecvt(3) 

fopen(3) 
ferror(3) 

ferror(3) 
ff(1> 

fclose(3) 
getc(3) 

getgrent(3) 

getpwent(3) 

gets(3) 
grep(1) 
utime(2) 

ldfcn(4) 
access(2) 
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tar: tape 


file archiver. 


tard) 


cpio: copy 


file archives in and out. 


cpio(1) 


pwck, grpck: 
password/group 


file checkers. 


pwck(1) 


chmod: change mode of 


file. 


chmod(2) 


change owner and group 
of a 


file, chown: 


chown(2) 


diff: differential 


file comparator. 


diff(D 


diff 3: 3-way differential 


file comparison. 


diff 3(1) 


fcntl: 


file control. 


fcntl(2) 


fcntl: 


file control options. 


fcntl(5) 


system-to-computer 
system 


file copy, /public 
computer 


■■■■tn/ 1 \ 

UUT.01 1 J 


core: format of core 


file. 


core(4) 


image 






umask: set and get 


file creation mask. 


umask(2) 


crontab-user crontab 


file. 


crontab(l) 


fields of each line of a 


file, cut: cut out selected 


cut(1) 


dd: convert and copy a 


file. 


ddd) 


a delta (change) to an 

sees 


file, delta: make 


deltad) 


close: close a 


file descriptor. 


close(2) 


dup: duplicate an open 


file descriptor. 


dup(2) 


wmsetid, wmsetids: 
associate a 


file descriptor with a 
window. 


wmsetid(3) 




file: determine file type. 


filed) 


hd: hexadecimal and ascii 


file dump. 


hdd) 


selected parts of an 


file, dump: dump 


dumpd) 



object 
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sact: print current SCCS 

endgrent, fgetgrent: get 
group 

fgetpwent: get password 

utmpname: access utmp 

putpwent; write 
password 

execlp, execvp: execute a 

grep, egrep, fgrep: 
search a 

path: locate executable 

Idaopen: open a common 
object 

aliases: aliases 

ar: common archive 

intro: introduction to 

entries of a common 
object 

get: get a version of an 
SCCS 

group: group 
files, filehdr: 

file. Idfhread: read the 

Idohseek: seek to the 
optional 

split: split a 

issue: issue identification 



file editing activity, 
file entry, /setgrent, 

file entry, /endpwent, 
file entry, /endutent, 
file entry. 

file, /execv, execle, 
execve, 

file for a pattern. 

file for command, 
file for reading. Idopen, 

file for sendmail. 
file format, 
file formats. 

file function, /line number 

file. 

file. 

file header for common 
object 

file header of a common 
object 

file header of a common 
object/ 

file into pieces, 
file. 



sact(1) 
getgrent(3) 

getpwent(3) 
getut(3) 
putpwent (3) 

exec(2) 

grep(1) 

path(1) 
ldopen(3) 

aliases(5) 
ar(4) 
intro(4) 
ldlread(3) 

get(1) 

group{4) 
filehdr(4) 

ldfhread(3) 

ldohseek(3) 

split(1) 
issue(4) 
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of a member of an 
archive 


file, /read the archive 
header 


ldahread(3) 


close a common object 


file. Idclose, Idaclose: 


ldclose(3) 


file header of a common 
abject 


tile. Idtnread. read tne 


IHfhrsaHfll 


a section of a common 
object 


file, /line number entries of 


litlcaakni 
IQlSeeK\JJ 


file header of a common 
object 


file, /seek to the optional 




a section of a common 
object 


file, /relocation entries of 


Irlreanlrfll 

IOTS66MJJ 


header of a common 
object 


file, /indexed/named 
section 


idsnreauwi 


section of a common 
object 


file, /to an 
indexed/named 


IOSS8eKV<3r 


table entry of a common 
object 


file, /the index of a 
symbol 


luluinQ6X\J/ 


table entry of a common 
object 


file, /read an indexed 
symbol 


IdtbreadO) 


table of a common object 


file, /seek to the symbol 


ldtbseek(3) 


entries in a common 
object 


file, linenum: line number 


linenum(4) 


link: link to a 


file. 


link(2) 


access to regions of a 


file, locking: exclusive 


locking(2) 


mknod: build special 


file. 


mknod(l) 


or a special or ordinary 


file, /make a directory, 


mknod(2) 


ctermid: generate 


file name for terminal. 


ctermid(3) 


mktemp: make a unique 


file name. 


mktempp) 


a file system, ff: list 


file names and statistics for 


ff(1) 


change the format of a text 


file, newform: 


newform(l) 
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name list of common 
object 

null: the null 

/find the slot in the utmp 

Input/output on a BTOS 

ofRename: rename a 
BTOS 

one. creat: create a new 
passwd: password 
or subsequent lines of one 
soft-copy terminals, pg: 
/rewind, ftell: reposition a 
Iseek: move read/write 
activity/ fpsar: 
prs: print an SCCS 
read: read from 
for a common object 

remove a delta from an 
SCCS 

bfs: big 

two versions of an SCCS 

sccsfile: format of SCCS 

header for a common 
object 

ofSetFileStatus: BTOS 



file, nm: print 
file. 

file of the current user, 
file. ofRead, ofWrite: 
file. 

file or rewrite an existing 
file. 

file, /lines of several files 

file perusal filter for 

file pointer in a stream. 

file pointer. 

File Processor system 

file. 

file. 

file, /relocation 
information 

file, rmdel: 

file scanner. 

file, sccsdiff: compare 

file. 

file, scnhdr: section 

File Status. 
ofGetFileStatus, 



nm(1) 

null(6) 
ttyslot(3) 
ofread(3) 
ofrenamep) 

creat(2) 

passwd{4) 

pasted) 

pg(D 

fseek(3) 

lseek(2) 

fpsar(1) 

prs(1) 

read(2) 

reloc{4) 

rmdel(l) 

bfs(1) 
sccsdiff (1) 
sccsfile(4) 
scnhdr(4) 

ofstatus{3) 
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stat, fstat: get 


file status. 


stat(2) 


from a common object 


filo /lino nnmhor 

Hie. / III Ic HUMIUCI 

information 


striod) 

Oil *|* \ • 1 


checksum and block 
count of a 


filp ctinv nrint 

1 IIC oUIII. |JI II 1 L 


sum(1) 


swrite: synchronous 
write on a 


file. 


swrite(2) 


/symbol name for 
common object 


file symbol table entry. 


ldgetname(3) 


syms: common object 


file symbol table format. 


syms(4) 


and interactive/ fsck, 
dfsck: 


file system consistency 
check 


fsck(1) 


fsdb: 


file system debugger. 


fsdb(1) 


names and statistics for a 


file system, ff : list file 


Mill 

ff(D 


fs: format of 


file system. 


fs(4) 


mkfs: construct a 


file system. 


mkfslD 


umount: mount and 
dismount 


file system, mount. 


mount(1) 


mount: mount a 


file system. 


mount(2) 


copy to or from the 
BTOS 


filo cvctoni nfrnnv* 

IliC dyolCIII. UlbUpj. 


ofcoDv(l) 

"l«V(l 1**1 


crup: create 


file system partition 
(slice). 


crup(1) 


ustat: get 


file system statistics. 


ustat(2) 


mnttab: mounted 


file system table. 


mnttab(4) 


umount: unmount a 


file system. 


.1 At 

umount(2) 


access time, dcopy: copy 


file systems for optimal 


dcopy(1) 


fsck. checklist: list of 


file systems processed by 


checklist(4) 


volcopy, labelit: copy 


file systems with label/ 


volcopyd) 


deliver the last part of a 


file, tail: 


taild) 
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term: format of compiled 
term 


file. 


term (4) 


tmpfiie: create a 
temporary 


file. 


tmpfile(3) 


create a name for a 
temnorarv 

LvlllUWIUl ¥ 


file, tmpnam, tempnam: 


tmpnam(3) 


and modification times of a 


flip tnnrn* iinrlato arrocc 
inc. IUULII. uUUdlc dlrbcSS 


ioucn\ I j 


ftw: walk a 


file tree. 


ftw(3) 


file: determine 


file type. 


filed) 


undo a previous get of 
an SCCS 


file, unget: 


unget(l) 


reDort reoeateri linps in a 

lU^IVI 1 i vpuuivu HI l&O III u 


flip unifi' 

IIIC. UlllUj. 


uniq(1) 


val' validate SCCS 


filp 
MIC. 


val(l) 


writP' writp nn a 

WHIG. WIHC Ull 0 


me. 


write(2) 


umask: set 


iiic urcdiiun mooe masK. 


umask(i) 


common object files. 


filehdr: file header for 


filehdr(4) 


ferror, feof, clearerr. 


fileno: stream status/ 


ferror(3) 


create and administer 
SCCS 


files, admin: 


admin(l) 


/improvement in large 


files and direct I/O. 


pilf(5) 


ofls: list BTOS 


files and directories. 


ofls(1) 


cat: concatenate and 
print 


files. 


cat(1) 


cmp: compare two 


files. 


cmp(1) 


lines common to two 
sorted 


files, comm: select or 
reject 


comm(1 ) 


cp. In, mv: copy, link or 
move 


files. 


mil \ 


file header for common 
object 


files, filehdr: 


filehdr(4) 



lndex-37 



find: find 

free: recover 

format specification in 
text 

cpset: install object 

intro: introduction to 
special 

link editor for common 
object 

lockf: record locking on 

ofDelete: Allocate BTOS 

ofed, ofvi: edit BTOS 

ofCloseAIIFiles: Access 
BTOS 

rm, rmdir: remove 

/merge same lines of 
several 

unpack: compress and 
expand 

pr: print 

section sizes of common 
object 

sort: sort and/or merge 
/object and archive 
what: identify SCCS 
terminals, pg: file perusal 
nl: line numbering 
col: 

/exCnxSendOnDealloc: 
make 



files 

files from a backup tape, 
files, fspec: 

files in binary directories, 
files. 

files. Id: 

files. 

files. /ofChangeFileLength. 
files. 

files. /ofCloseFile, 

files or directories. 

files or subsequent lines of/ 

files, pack, peat, 

files. 

files, size: print 
files. 

files to common formats, 
files. 

filter for soft-copy 
filter. 

filter reverse line-feeds, 
final requests. 



find(1) 
frec(l) 
fspec(4) 

cpset(l) 
intro(6) 

ld(1) 

lockf(3) 
ofcreate(3) 
ofeditors(l) 
ofopenfile(3) 

rm(1) 
paste(l) 

packd) 

prd) 
size(l) 

sort(l) 

convert(l) 

whatd) 

pg(D 

nl{1) 

cold) 

exfinal(2) 
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fine: fast incremental 
backup. 


finc(l) 


find: 


find files. 


find(1) 




find: find files. 


find(l) 


hyphen: 


find hyphenated words. 


hyphen! 1) 


ttyname, isatty: 


find name of a terminal. 


ttyname(3) 


object library, lorder: 


find ordering relation of an 


lorderO) 


nasnmaice, spenirt, 
hashcheck: 


find spelling errors, spell. 


spell(l) 


of the current user, 
ttyslot: 


find the slot in the utmp file 


ttyslot{3) 


fold: fold long lines for 


finite width output device. 


fold(1) 


tee: pipe 


fitting. 


tee(l) 


atof: convert ASCII 
string to 


floating-point number. 


atof(3) 


ecvt, fcvt, gcvt: convert 


floating-point number to/ 


ecvt(3) 


/modf: manipulate parts 
of 


floating-point numbers. 


frexp(3) 


floor, ceiling, remainder,/ 


floor, ceil, fmod, fabs: 


floor(3) 


floor, ceil, fmod, fabs: 


floor, ceiling, remainder,/ 


floor{3) 


/cartridge, and 


floppy disks. 


dsk(6) 


cflow: generate C 


flow graph. 


cflowd) 


fclose, fflush: close or 


flush a stream. 


fclose(3) 


remainder,/ floor, ceil. 


fmod, fabs: floor, ceiling. 


floor(3) 


finite width output 
device. 


fold: fold long lines for 


fold(l) 


width output device, 
fold: 


fold long lines for finite 


fold(l) 



stream. 



ar: common archive file 
newform: change the 
i-node: 
term: 

core: 
cpio: 
dir: 
fs: 

sccsfile: 
files, fspec: 

object file symbol table 

archive files to common 

intro: introduction to file 

wtmp: utmp and wtmp 
entry 

scant, fscanf, sscanf: 
convert 

/vfprintf, vsprintf: print 

reporter, fpsar: 

fprintf, sprintf: print 

system activity/ 

word on a/ putc, 
putchar, 



fopen, freopen, fdopen: fopen(3) 
open a 

fork: create a new fork(2) 
process. 

format. ar(4) 

format of a text file. newform(l) 

format of an i-node. inode(4) 

format of compiled term term(4) 
file. 

format of core image file. core(4) 

format of cpio archive. cpio(4) 

format of directories. dir(4) 

format of file system. fs(4) 

format of SCCS file. sccsfile(4) 

format specification in fspec(4) 
text 

format, syms: common syms(4) 

formats, /object and convert(l) 

formats. >ntro(4) 

formats, utmp, utmp(4) 

formatted input. scanf(3) 

formatted output of a vprintf(3) 
varargs/ 

fp system activity fpsar(l) 

formatted output, printf, printf{3) 

fpsar: File Processor fpsar(l) 

fputc, putw: put character putc(3) 
or 
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stream, puts. 


fputs: put a string on a 


puts{3) 


input/output. 


fread, fwrite: binary 


fread(3) 


backup tape. 


free: recover files from a 


freed ) 


df: report number of 


froo Hiclr hlnrUo 
Wcc UtoK DIUCKS. 


Old) 


memory allocator, malloc, 


free, realloc, calioc: main 




mallopt, mallinfo:/ 
malloc, 


free, realloc, calioc. 


malloc(3) 


stream, fopen. 


freopen, fdopen* open a 




parts of floating-point/ 


frexp, Idexp, modf: 

maninnfato 
niaiiijjuidic 


frexp(3) 


free: recover files 


from a backup tape. 


freed ) 


/and line number 
information 


from a common object 
file. 


strip(l) 


getw: get character or 
word 


from a stream, /fgetc. 




gets, fgets: get a string 


from a stream. 


gets(3) 


rmdel: remove a delta 


from an SCCS file. 


rmdel(l) 


getopt: get option letter 


from argument vector. 


getopt(3) 


read: read 


from file. 


read(2) 


ncheck: generate names 


from i-numbers. 


nrhnrlf M ) 


nlist: get entries 


from name list. 


nlist(3) 


ofcopy: copy to or 


from the BTOS file 
system. 


nfcnnvf It 


getpw: get name 


from UID. 


getpw(3) 




fs: format of file svstpm 




formatted input, scanf, 


fscanf, sscanf: convert 




a lost + found directory for 


fsck. mklost+ found: 
make 


mklost+foundd) 


of file systems processed 


fsck. checklist: list 


cheeklist(4) 
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consistency check and/ fsck, dfsck: file system fsck(1) 

fsdb: file system fsdb{1) 
debugger. 

reposition a file pointer in/ fseek, rewind, fftell: fseek(3) 

size. fsize: calculate file fsize(l) 

text files. fspec: format specification fspec(4) 

in 

or efl files. fsplit: split fortran, ratfor, fsplit(l) 

stat, fstat: get file status. stat(2) 

pointer in a/ fseek, ftell: reposition a file fseek(3) 

rewind, 

communication package (ftok). /standard stdipc(3) 
interprocess 

ftw: walk a file tree. ftw(3) 

error/ erf, erfc: error function and erf{3) 

complementary 

and complementary error function, /error function erf(3) 

gamma: log gamma function. . gamma(3) 

hypot: Euclidean distance function. hypot(3) 

of a common object file function, /line number ldlread(3) 
entries 

matherr: error-handling function. matherr(3) 

prof: profile within a function. prof(5) 

math: math functions and constants. math(5) 

jO, j1, jn, yO, y1, yn: functions. bessel(3) 

Bessel 

logarithm, power, square functions, /sqrt: exp(3) 
root exponential, 

remainder, absolute value functions, /floor, ceiling, floor(3) 

ocurse: optimized screen functions. ocurses(3) 
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BTOS directory 

sinh, cosh, tanh: 
hyperbolic 

atan, atan2: 
trigonometric 

fread, 

connect accounting 
records. 

gamma: log 

number to string, ecvt, 
fcvt, 

abort: 

cflow: 

reference, cxref: 
terminal, ctermid: 
crypt, setkey, encrypt: 
ncheck: 

lexical tasks, lex: 

/srand48, seed48, 
lcong48: 

srand: simple 
random-number 

gets, fgets: 

get: 

ulimit: 

the user, cuserid: 



functions. 
/ofReadDirSector: 

functions. 

functions, /tan, asin, 
acos, 

fwrite: binary 
input/output. 

fwtmp, wtmpfix: 
manipulate 

gamma function. 

gamma: log gamma 
function. 

gcvt: convert floating-point 

generate an I0T fault 

generate C flow graph. 

generate C program cross 

generate file name for 

generate DES encryption. 

generate names from 
i-numbers. 

generate programs for 
simple 

generate uniformly 
distributed/ 

generator, rand, 

get a string from a 
stream. 

get a version of an SCCS 
file. 

get and set user limits, 
get character login name of 



ofdir(3) 

sinh(3) 

trig(3) 

fread(3) 

fwtmp(l) 

gamma(3) 
gamma(3) 

ecvt(3) 

abort(3) 

cflow(l) 

cxref(l) 

ctermid(3) 

crypt{3) 

ncheck(l) 

lex(1) 

drand48(3) 

rand(3) 

gets(3) 

get(1) 

ulimit(2) 
cuserid(3) 
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getc, getchar, fgetc, 


get character or word 


n Atrial 


getw. 


from a/ 




nlist: 


get entries from name list. 


nlist(3) 


umask: set and 


get file creation mask. 


umask(2) 


stat, fstat: 


get file status. 




ustat: 


get file system statistics. 


it stat 1 21 


file. 


get: get a version of an 

ooUo 


get(1) 


setgrent, endgrent, 


get group me emry. 


getgrent(3) 


fgetgrent: 






getlogin: 


get login name. 


getlogin(3) 


logname: 


get login name. 


logname(l) 


msgget: 


get message queue. 


men not I 7 1 


getpw: 


n nt namo frnm 1 II 11 
□el Ildlllc iiuiii uiu. 


getpw (3) 


system, uname: 


.»( nAinA at f*i i front 

gel name ui uuricni 


uname(2) 


CENTIX 




unget: undo a previous 


npt nf an SCCS file 

Ucl UI Oil Wl/OkJ 1MB. 


unget(1) 


argument vector, getopt: 


get option letter from 


nptnntf 


setpwent, endpwent. 


get password file entry. 


getpwent(3) 


fgetpwent: 






working directory. 


get path-name of current 


getcwd(3) 


getcwd: 






times, times: 


get process and child 
process 


times(2) 


and/ getpid, getpgrp, 


get process, process 


getpid(2) 


getppid: 


group, 




/geteuid, getgid, getegid: 


get real user, effective 
user,/ 


geiuiu\£j 


semget: 


get set of semaphores. 


semget(2) 


shmget: 


get shared memory 


shmget(2) 


segment. 





wmlayout: get terminal's window wmlayout(3) 

layout. 
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tty: 

time: 

wmgetid: 

get character or word 
from a/ 

character or work from/ 
getc. 

current working 
directory. 

getuid, geteuid, getgid, 

environment name. 

real user, effective/ 
getuid, 

user,/ getuid, geteuid, 
setgrent, endgrent,/ 

endgrent,/ getgrent, 

getgrent, getgrgid. 



argument vector. 



process group, and/ 
getpid, 

process, process group, 
and/ 

group, and/ getpid, 
getpgrp. 



get the terminal's name. 

get time. 

get window 10. 

getc, getchar, fgetc, getw: 

getchar, fgetc, getw: get 

getcwd: get path-name of 

getegid: get real user,/ 

getenv: return value for 

geteuid, getgid, getegid: 
get 

getgid, getegid: get real 

getgrent, getgrgid, 
getgrnam, 

getgrgid, getgrnam, 
setgrent, 

getgrnam, setgrent, 
endgrent,/ 

getlogin: get login name. 

getopt: get option letter 
from 

getopt: parse command 
options. 

getpass: read a password. 

getpgrp, getppid: get 
process, 

getpid, getpgrp, getppid: 
get 

getppid: get process, 
process 

getpw: get name from 
UID. 



tty(1) 
time(2) 
wmgetid(3) 
getc(3) 

getc{3) 

getcwd(3) 

getuid(2) 
getenv(3) 
getuid(2) 

getuid(2) 
getgrent(3) 

getgrent(3) 

getgrent(3) 

getlogin(3) 
getoptO) 

getopt(l) 

getpass(3) 
getpid(2) 

getpid(2) 

getpid(2) 

getpw(3) 
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setpwent, endpwent,/ 


getpwent, getpwuid, 

nptnuunnm 
yciu wi 101 11 , 


getpwentlJ) 


getpwent, getpwuid. 


getpwnam, setpwent, 


getpwent(3) 


endpwent,/ 




endpwent,/ getpwent. 


getpwuid, getpwnam, 


getpwent(3) 


Qptnwpnt 




a stream. 


gets, fgets: get a string 
from 


... J 0\ 

gets(J) 


and terminal settings 


nottu nottvHpfc* <inppd 
ycuy. yciiyucia. opccu 


gettydefs(4) 


used by 






modes, speed, and line/ 


nottu* cpt tprminal tvoG 


getty(l) 


ct: spawn 


getty to a remote 


ct(1) 


terminal. 




settings used by getty. 


nottvripfc* ^nppd and 


gettydefs(4) 


terminal 




• 

getegid: get real user,/ 


notiiiH nptpiiid nptnin 

yclUIUf yclCUiu, yciyiu, 


getuid(2) 


pututline, setutent,/ 


getutent, getutid, 


getuiui 


getutline. 




setutent, endutent,/ 


getutid, getutline. 


g6iui\oj 


getutent. 


niitntlinp 

JJUIULHI IC, 




setutent,/ getutent, 


getutline, pututline. 


getuiiJj 


notiitiri 
yeiuuu. 






frnm i i notP flOtrflAr 

TfUlTI a/ yclL, yeiuiai. 


getw: get character or 


getc(3) 


fnotr 
lyoiu, 


word 




convert/ ctime, localtime, 


gmtime, asctime, tzset: 


ctime(3) 


tptimn lonoimD" 


goto. 


setjmp(3) 


non-local 






sag: system activity 


graph. 


sag(1) 


plot: 


graphics interface. 


plot(4) 


subroutines, plot: 


graphics interface 


plot(3) 


/for typesetting view 


graphs and slides. 


mv(5) 


file for a pattern. 


grep, egrep, fgrep: search a 


grep(1) 
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/user, effective user, real 

/getppid: get process, 
process 

chown, chgrp: change 
owner or 

endgrent, fgetgrent: get 
group: 

setpgrp: set process 

id: print user and 

real group, and effective 

setuid, setgid: set user and 

newgrp: log in to a new 

chown: change owner 
and 

a signal to a process or a 
update, and regenerate 

checkers, pwck, 

ssignal, 

terminal download, tdl, 
processing, shutdown, 
varargs: 

package, curses: CRT 
screen 



group, and effective 
group/ 

group, and parent process 
IDs. 

group. 

group file entry, /setgrent, 
group file, 
group:, group file, 
group ID. 

group IDs and names, 
group IDs. /effective user, 
group IDs. 
group. 

group of a file. 

group of processes, /send 

groups of programs, 
/maintain, 

grpck: password/group 
file 

gsignal: software signals. 

gtdl, ptdl: RS-232 

halt: terminate all 

handle variable argument 
list. 

handling and optimization 



getuid(2) 

getpid(2) 

chown{1) 

getgrent(3) 

group{4) 

group(4) 

setpgrp(2) 

id(1) 

getuid(2) 

setuid(2) 

newgrp(l) 

chown{2) 

kill(2) 
make(l) 

pwck(1) 

ssignal(3) 
tdl(1) 

shutdown! 1) 
varargs(5) 

curses{3) 
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nohup: run a command 
immune to 

hcreate, hdestroy: 
manage 

spell, hashmake, spellin, 
/encrypt: generate 
hashcheck: find/ spell, 
search tables, hsearch, 

dump. 

tables, hsearch, hcreate, 

file, scnhdr: section 

files, filehdr. file 

file. Idfhread: read the file 

/seek to the optional file 

/read an indexed/named 
section 

Idahread: read the 
archive 

help: ask for 
dump, hd: 

manage hash search 
tables. 

sinh, cosh, tanh: 



hyphen: find 



hangups and quits. 

hash search tables 
hsearch, 

hashcheck: find spelling/ 

hashing encryption. 

hashmake, spellin, 

hcreate, hdestroy: manage 
hash 

hd: hexadecimal and ascii 
file 

hdestroy: manage hash 
search 

header for a common 
object 

header for common object 

header of a common 
object 

header of a common 
object/ 

header of a common 
object/ 

header of a member of an/ 

help: ask for help, 
help. 

hexadecimal and ascii file 
hsearch, hcreate, hdestroy: 

hyperbolic functions. 

hyphen: Find hyphenated 
words. 

hyphenated words. 



nohup(l) 

hsearch(3) 

spelKD 
crypt(3) 
spelKD 
hsearchp) 

hd(1) 

hsearch(3C) 

scnhdr(4) 

filehdr(4) 
IdfhreadO) 

ldohseek(3) 

ldshread(3) 

ldahread(3) 

helpO) 
hetp(l) 
hd(1) 
hsearch(3) 

sinh(3) 
hyphen(l) 

hyphen(l) 



1192192 



lndex-48 



function. 


hypot: Euclidean distance 


hypot(3) 


exWait, exCheck: 
examine an 


ICC message queue. 


exwait(2) 


processor, pstat: 


ICC statistics for 


pstat(l) 


control initialization, init. 


icode, telinit: process 


init(1) 


semaphore set or shared 
memory 


id. /remove a message 
queue, 


ipcrm(l) 


and names. 


id: print user and group IDs 


id(1) 


setpgrp: set process 
group 


ID. 


setpgrp(2) 


wmgetid: get window 


ID. 


wmgetidp) 


issue: issue 


identification file. 


issue(4) 


what: 


identify SCCS files. 


what(1) 


id: print user and group 


IDs and names. 


id{1) 


nrniin and naront 
yiuup, emu umclll 

process 


IDs. /get process, process 


getpid(2) 


nrniin anrf offanttwa 
yiuup, dim clIcl/UVc 

group 


IDs. /effective user, real 


getuid(2) 


setgid: set user and 
group 


IDs. setuid. 


setuid{2) 


core: format of core 


image file. 


core(4) 


crash: examine system 


images. 


crash! 1) 


nnhl in* run 3 r*nmm*anrl 
iiUMU[J. lull a lUIIHIIdliU 


immune to hangups and 
quits. 


nohupU) 


direct/ pilf, dio: 
performance 


improvement in large files 
and 


pilf(5) 


fine: fast 


incremental backup. 


finr(1J 


tgoto, tputs: terminal 


independent operations. 


termcap(3) 


for formatting a 
permuted 


index, /the macro package 


mptx(5) 
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of a/ Idtbindex: compute 
the 


index of a symbol table 
entry 


laiuinaexv of 


a common/ Idtbread: 
read an 


indexed symbol table entry 
of 


litthrAaitfll 


Idshread, Idnshread: read 
an 


indexed/named section 
header/ 


iusnreau\of 


Idsseek, Idnsseek: seek 
to an 


indexed/named section of 
a/ 


ldsseek(3) 


control initialization. 


init, icode, telinit: process 


initd) 


inittab: script for the 


init process. 


inittab(4) 


tellinit: process control 


initialization, init, icode. 


init(l) 


rc, allrc, conrc: system 


initialization shell scripts. 


brc(l) 


process, popen, pclose: 


initiate pipe to/from a 


popen(3) 


process. 


inittab: script for the init 


inittab(4) 


clri: clear 


i-node. 


clrid) 




inode: format of an i-node 


inode(4) 


inode: format of an 


i-node. 


inode(4) 


convert formatted 


input, /fscanf, sscanf: 


scanf(3) 


push character back into 


input stream, ungetc: 


ungetc(3) 


fread, fwrite: binary 


input/output. 


fread(3) 


ofRead, ofWrite: 


Input/output on a BTOS 
file. 


ofread(3) 


stdio: standard buffered 


input/output package. 


stdio(3) 


fileno: stream status 


inquiries, /feof, clearerr, 


ferror(3) 


uustat: uucp status 


inquiry and job control. 


uustatd) 


install* 


install commands. 


installd) 




install: install commands. 


install(l) 


directories, cpset: 


install object files in 
binary 


cpsetd) 
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tset: set terminal, 
terminal 


interface, and terminal/ 


tset(1) 


abs: return 


integer absolute value. 


abs(3) 


/164a: convert between 
long 


integer and base-64 
ASCII/ 


a64l(3) 


sputl, sgetl: access long 


integer data in a/ 


sputl(3) 


atol, atoi: convert string to 


integer, strtol. 


strtoi(3) 


/tol3: convert between 
3-byte 


integers and long integers. 


l3tol{3) 


3-byte integers and long 


integers, /convert 
between 


l3tol{3) 


bcopy: 


interactive block copy. 


bcopy(l) 


command line interpreter 
for 


interactive BTOS JCL. 
ofcli: 


ofcli(l) 


system consistency check 
and 


interactive repair, /file 


fsck(1) 


mt: 


interface for magnetic 
tape. 


mt(6) 


Ip: parallel printer 


interface. 


lp(6) 


plot: graphics 


interface. 


plot(4) 


plot: graphics 


interface subroutines. 


plot(3) 


termio: general terminal 


interface. 


termio(6) 


tty: controlling terminal 


interface. 


tty(6) 


BTOS JCL. ofcli: 
command line 


interpreter for interactive 


ofcli(l) 


pipe: create an 


interprocess channel. 


pipe(2) 


facilities/ ipcs: report 


inter-process 
communication 


ipcs(1) 


package/ stdipc: 
standard 


interprocess 
communication 


stdipc(3) 


suspend execution for an 


interval., sleep: 


sleep(l) 



sleep: suspend executin 
far 

commands and 
application/ 

formats. 

miscellany. 

files. 

subroutines and libraries, 
calls and error numbers. 

applicaton programs, 
intro: 

intra: 

intro: 
intro: 

and libraries, intro: 
and error numbers, intro: 

ncheck: generate names 
from 

in large files and direct 

abort: generate an 

semaphore set or 
shared/ 

communication facilities/ 
/islower, isdigit, isxdigit, 
isdigit, isxdigit, isalnum,/ 



interval. sleep(3) 

intra: introduction to intro(l) 

intra: introduction to file intro(4) 

intra: introduction to intro(5) 

intro: introduction to intro(6) 
special 

intra: introduction to intro(3) 

intro: introduction to intro(2) 
system 

introduction to commands intro(l) 
and 

introduction to file intro(4) 
formats. 

introduction to miscellany. intro(5) 

introduction to special intro{6) 
files. 

introduction to subroutines intro(3) 

introduction to system intro{2) 
calls 

i-numbers. ncheck(l) 

I/O. /performance pilf(5) 
improvement 

ioctl: control device. ioctl{2) 

I0T fault. abort(3) 

ipcrm: remove a message ipcrm(l) 
queue, 

ipcs: report inter-process ipcs(l) 

isalnum, isspace, ispunct,/ ctype(3) 
isalpha, isupper, islower, ctype(3) 
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/isprint, isgraph, iscntrl, 


isascii: classify characters. 


ctype(3) 


terminal, ttyname, 


isatty: find name of a 


ttyname(3) 


/ispunct, isprint, isgraph. 


iscntrl, isascii: classify/ 


ctype(3) 


isalpha, isupp6r, islower, 


krlinit i^xriinit isalnum / 


rtvnnf 


isspace, ispunct, isprint, 


isgraph, iscntrl, isascii:/ 


ctype(3) 


isalnum,/ isalpha, 
isuDDer. 


islower, isdigit, isxdigit. 


ctype(3) 


/isalnum, isspace, 
ispunct. 


isprint, isgraph, iscntrl,/ 


CtVDfi(3) 


isxdigit, isalnum, isspace, 


ispunct, isprint, isgraph,/ 


ctype(3) 


/isdigit, isxdigit, isalnum, 


isspace, ispunct, isprint,/ 


ctype{3) 


system: 


issue a shell command. 


system(3) 


issue: 


ksitp iiipntifiratinn filp 

iOOUC IUCI 1 111 IUuLll/1 ■ inc. 


■ QQIICtf/Ll 


file. 


issue: issue identification 


issu6(4) 


isxdigit, isalnum,/ 
isalpha, 


kiinnpr klnwpr kiiinit 




/isupper, islower, isdigit. 


isxdigit, isalnum, isspace,/ 


ctype(3) 


news: print news 


items. 


news(1) 


functions. 


iO i1 in vO v1 vn* BpsspI 




functions. jO 


il in vO vl vn* Bessel 




for interactive BTOS 


JCL /rnmmanri linp 
interpreter 




fnnrtinns ifl il 


in ufl u i un* Roccol 
yu, yi, yu. ucadci 




operator. 


join: relational database 


join(1) 


Irand48, nrand48, 
mrand48, 


jrand48, srand48, 
seed48,/ 


drand48(3) 


mkboot: reformat CENTIX 


kernel and copy it to 
BTOS. 


mkboot(l) 



killall: 


kill all active processes. 


killall(l) 


process or a group of/ 


kill: send a signal to a 


kill(2) 




kill: terminate a process. 


kill(l) 


processes. 


killall: kill all active 


killalKD 


mem. 


kmem: core memory. 


mem(6) 


3-byte integers and 
long/ 


l3tol, ltol3: convert 
between 


l3tol(3) 


integer and base-64/ 
a64l, 


164a: convert between 
long 


aG4l(3) 


copy file systems with 


label checking, /labelit: 


volcopy(l) 


with label checking, 
volcoov. 


labelit: copy file systems 


volcopy(l) 


scanning and processing 


language, awk: pattern 


awk(1) 


arbitrary-precision 
arithmetic 


language, be: 


hc(1) 


cpp: the C 


language preprocessor. 


eppd) 


command programming 


language. 

/standard/restricted 


sh(1) 


get terminal's window 


layout, wmlayout: 


wmlayout(3) 


/jrand48, srand48, 
seed48. 


lcong48: generate 
uniformly/ 


drand48(3) 


object files. 


Id: link editor for common 


ld(1) 


object file. Idclose, 


Idaclose: close a common 


ldclose(3) 


header of a member of an/ 


Idahread: read the archive 


ldahread(3) 


file for reading. Idopen, 


Idaopen: open a common 
object 


ldopen(3) 


pnmmnn nhiprt flip 

UUIHIIIUII UUJCUI MIC. 


IrirlfKP Idarlnsp" Mikp a 


ldclose(3) 


of floating-point/frexp. 


Idexp, modf: manipulate 
parts 


frexp(3) 


access routines. 


Idfcn: common object file 


ldfcn(4) 
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of a common object file. 



name for common object 
file/ 

line number entries/ 



number/ Idlread, Idlinit, 

manipulate line number/ 

to line number entries/ 

number entries of a 
section/ 

entries of a section/ 
Idrseek, 

indexed/named/ 
Idshread, 

indexed/named/ Idsseek, 
file header of a common/ 

object file for reading. 

relocation entries of a/ 

indexed/named section 
of a/ 

indexed/named section 
of a/ 

of a symbol table entry 
of a/ 



Idfhread: read the file 
header 

Idgetname: retrieve symbol 

Idlinit, Idlitem: manipulate 

Idlitem: manipulate line 

Idlread, Idlinit, Idlitem: 

Idlseek, Idnlseek: seek 

Idlseek, Idnlseek: seek to 
line 

Idnrseek: seek to 
relocation 

Idnshread: read an 

Idnsseek: seek to an 

Idohseek: seek to the 
optional 

Idopen, Idaopen: open a 
common 

Idrseek, Idnrseek: seek to 
Idshread, Idnshread: read an 

Idsseek, Idnsseek: seek to 
an 

Idtbindex: compute the 
index 



symbol table entry of a/ Idtbread: read an indexed 



table of a common 
object/ 

getopt: get option 



Idtbseek: seek to the 
symbol 

letter from argument 
vector. 



IdfhreadO) 

ldgetname(3) 

ldlread(3) 

IdlreadO) 
IdlreadO) 
IdlseekO) 
ldlseek(3) 

!drseek(3) 

Idshreadp) 

IdsseekO) 
ldohseek(3) 

ldopen(3) 

ldrseek(3) 
ldshread(3) 

IdsseekO) 

ldtbindex(3) 

IdtbreadO) 
ldtbseek(3) 

getopt(3) 
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simple lexical tasks. lex: generate programs for lax(1) 

generate programs for lexical tasks, lex: lex(1) 
simple 

update. Isearch, Ifind: linear search and lsearch(3) 

to subroutines and libraries, /introduction intro(3) 

relation for an object library, /find ordering lorder(l) 

portable/ ar: archive and library maintainer for ar(1) 

ulimit: get and set user limits. ulimit(2) 

an out-going terminal line connection, /establish dial(3) 

type, modes, speed, and line discipline, /set getty(l) 
terminal 

interactive/ ofcli: line interpreter for ofcli(l) 
command 

line: read one line. lined ) 

common object file. line number entries in a linenum(4) 
linenum: 

/Idlinit, Idlitem: line number entries of a/ ldlread(3) 
manipulate 

Idlseek, Idnlseek: seek to line number entries of a/ ldlseek(3) 

strip: strip symbol and line number information strip! 1) 
from a/ 

nl: line numbering filter. nl(1) 

out selected fields of line of a file, cut: cut cut(1) 
each 

send/cancel requests to line printer, Ip, cancel: lp(1) 
an LP 

Ipset: set parallel line printer options. Ipset(l) 

|pr: line printer spooler. Ipr(1) 

line: read one line. lined ) 

Isearch, Ifind: linear search and update. IsearchO) 
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col: filter reverse 

in a common object file 

files, comm: select or 
reject 

device, fold: fold long 

head: give first few 

uniq: report repeated 

of several files or 
subsequent 

subsequent/ paste: 
merge same 

link, unlink: exercise 
files. Id: 

a.out: common assembler 
and 

cp. In, mv: copy, 
link: 

and unlink system calls. 

Is: 

directories, ofls: 
for a file system, ff: 

nlist: get entries from 
name 

nm: print name 
by fsck. checklist: 



line-feeds. 

linenum: line number 
entries 

lines common to two 
sorted 

lines for finite width 
output 

lines. 

lines in a file. 

lines of one file, /same lines 

lines of several files or 

link and unlink system 
calls. 

link editor for common 
object 

link editor output. 

link: link to a file. 

link or move files. 

link to a file. 

link, unlink: exercise link 

lint: a C program checker. 

list contents of directory. 

list BTOS files and 

list file names and 
statistics 

list. 

list of common object file. . 

list of file systems 
processed 



col(l) 
linenum(4) 

comm(l) 

fold(l) 

head(1) 
uniq(1) 
pasted ) 

pasted) 

link(1) 

ld(1) 

a.out(4) 

link(2) 

cp(1) 

link(2) 

link(1) 

lint(1) 

ls(1) 

oflsd) 

ff(D 

nlist{3) 

nmd) 
checklist^) 
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handle variable argument 


list, varargs: 


varargs(5) 


nntniit nf a vararn*; 


list, /print formatted 


vprintf(3) 


argument 






xargs: construct 


list(s) and execute 


xargs(1) 


argument 


command. 




files, cp. 


In, mv: copy, link or move 


cp(1) 


tzset: convert data/ 


localtime, gmtime, 


ctime(3) 


ctime, 


asctime, 




command, path: 


locate executable file for 


path(1) 


end, etext, edata: last 


locations in program. 


end(3) 


data in memory, plock: 


lock process, text, or 


plock(Z) 


files. 


lockf: record locking on 


lockf(3) 


regions of a file. 


locking: exclusive access to 


■ 1 ■ 111 

lockingu) 


lockf: record 


locking on files. 


lockfU) 


gamma: 


log gamma function. 


gamma(3) 


newgrp: 


log in to a new group. 


newgrplD 


pynnnpntial Innarithm / 

GAUUIIGI 1 imi, luyoi ill if I if / 


log, loglO, pow, sqrt: 


exp(3) 


exp, 






Innarithm nnwpr / fixn 


log 10, pow, sqrt: 


exp(3) 


log. 


exponential, 




/log 10, pow, sqrt: 


logarithm, power, square 


exp{3) 


exponential, 


root/ 




getlogin: get 


login name. 


getlogin(J) 


logname: get 


login name. 


logname! 1) 


cuserid: get character 


login name of the user. 


cuserid(3) 


logname: return 


login name of user. 


lognameU; 


passwd: change 


login password. 


passwd(l) 




login: sign on. 


login! 1) 


setting up an 


login time, profile: 


profiled! 


environment at 








logname: get login name. 


lognamed) 
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user. 

a64l, 164a: convert 
between 

sputl, sgetl: access 

between 3-byte integers 
and 

output device, fold: fold 
setjmp, 

for an object library. 

mklost+ found: make a 

nice: run a command at 

requests to an LP line/ 

send/cancel requests to 
an 

interface. 

disable: enable/disable 

Ipshut, Ipmove: 
start/stop the 

accept, reject: 
allow/prevent 

Ipadmin: configure the 

Ipstat: print 

spooling system. 

request/ Ipsched, Ipshut, 

start/stop the LP 
request/ 



logname: return login 
name of 

long integer and base-64 
ASCII/ 

long integer data in a/ 

long integers. /ltol3: 
convert 

long lines for finite width 

longjmp: non-local goto. 

lorder: find ordering 
relation 

lost + found directory for 
fsck. 

low priority. 

Ip, cancel: send/cancel 

LP line printer. Ip, cancel: 

Ip: parallel printer 

LP printers, enable, 

LP request scheduler and 
move/ 

LP requests. 

LP spooling system. 
LP status information. 
Ipadmin: configure the LP 
Ipmove: start/stop the LP 
Ipr: line printer spooler. 
Ipsched, Ipshut, Ipmove: 



logname(3) 

a64l(3) 

sputl(3) 
l3tol(3) 

fold(l) 

setjmp(3) 

lorderd) 

mklost+foundO) 

nice(1) 

lp(D 

lp(D 

lp(6) 

enabled) 
lpsched(1) 

accept! 1) 

Ipadmin(l) 

Ipstat(l) 

lpadmin(1) 

Ipsched! 1) 

Ipr(l) 

Ipschedd) 
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printer options. 


Ipset: set parallel line 


Ipset(l) 


LP request scheduler/ 
Ipsched, 


Ipshut, Ipmove: start/stop 
the 


Ipschedd) 


information. 


Ipstat: print LP status 


Ipstat(l) 


jrand48,/ drand48, 
erand48, 


Irand48, nrand48, 
mrand48, 


drand48(3) 


directory. 


Is: list contents of 


ls(1) 


and update. 


Isearch, Ifind: linear 
search 


lsearch(3) 


pointer. 


Iseek: move read/write 
file 


lseek{2) 


integers and long/ l3tol, 


ltol3:' convert between 

t.hvtp 


l3tol(3) 




m4: macro processor. 


m4(1) 


values: 


machine-dependent values. 


values(5) 


/access long integer data 

in a 


machine-independent 
fashion. 


sputl(3) 


permuted index, mptx: 
the 


macro package for 
formatting 


mptx(5) 


documents, mm: the MM 


macro package for 

form att inn 
iui iiidiiuiy 


mm(5) 


typesetting/ mv: a troff 


macro package for 


mv(S) 


m4: 


macro processor. 


m4(1) 


in this manual, man: 


macros for formatting 

ontnoc 


man(5) 


send mail to users or read 


mail mail rmail" 
■ Halt. Illdll, IHIdll. 


mail(l) 

IIIOIt| I / 


users or read mail. 


mail, rmail: send mail to 


mail(l) 


mail, rmail: send 


mail to users or read mail. 


mail(l) 


malloc, free, realloc, 
calloc: 


main memory allocator. 


malloc(3) 


/matlont mallinfo* fast 


main memory allocator. 


malloc(3) 
version) 


regenerate groups of/ 
make: 


maintain, update, and 


make(l) 
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ar: archive and library 


maintainer for portable/ 


ar{1) 


SCCS file, delta: 


make a delta (change) to an 


delta! 1) 


mkdir: 


make a directory. 


mkdir(l) 


or ordinary file, mknod: 


make a directory, or a 
special 


mknod(2) 


mktemp: 


make a unique file name. 


mktemp(3) 


exCnxSendOnDeal 
loc: 


make final requests. 


exfinal(2) 


regenerate groups of/ 


make: maintain, update, 
and 


make(1) 


banner: 


make posters. 


banner! 1) 


session, script: 


make typescript of 
terminal 


script( 1) 


realloc, calloc, mallopt, 


mallinfo: fast main 
memory/ 


mallocG) (1 
version) 


main memory allocator. 


malloc, free, realloc, 
calloc: 


malloc(3) 


mallopt, mallinfo: fast 
main/ 


malloc, free, realloc, 
calloc. 


malloc(3) 


malloc, free, realloc, 
calloc. 


mallopt, mallinfo: fast 
main/ 


malloc(3) (t 
version) 


/tfind, tdelete, twalk: 


manage binary search 
trees. 


tsearch(3) 


hsearch, hcreate, 
noesxroy. 


manage hash search 
tables. 


hsearch(3) 


wmop: window 


management operations. 


wmop(3) 


window: window 


management primitives. 


window(B) 


wm: window 


management. . 


wm(1) 


records, fwtmp, wtmpfix: 


manipulate connect 
accounting 


fwtmpd) 


of/ Idlread, Idlinit, 
luiiiem. 


manipulate line number 
entries 


ldlread(3) 


frexp, Idexp, modf: 


manipulate parts of/ 


frexp{3) 


ascii: 


map of ASCII character set. 


ascii(5) 


umask: set file-creation 
mode 


mask. 


umask(l) 



set and get file creation 

table, master: 

information table. 

regular expression 
commpile and 

math: 

constants, 
function, 
processor type. 

memcpy, memset: 
memory/ 

memset: memory/ 
memccpy, 

operations, memccpy, 
memchr, 

memccpy, memchr, 
memcmp, 

free, realloc, calloc: main 

mallopt, mallinfo: fast 
main 

shmctl: shared 

queue, semaphore set or 
shared 

mem, kmem: core 

memcmp, memcpy, 
memset: 

shmop: shared 

text, or data in 

shmget: get shared 



mask, umask: 
master device information 
master: master device 
match routines, regexp: 

math functions and 
constants. 

math: math functions and 

matherr: error-handling 

mc68k, pdp11, u3b, vax: 

mem, kmem: core 
memory- 

memccpy, memchr, 
memcmp, 

memchr, memcmp, 
memcpy, 

memcmp, memcpy, 
memset: memory 

memcpy, memset: 
memory/ 

memory allocator, malloc, 
memory allocator, /calloc, 

memory control 
operations. 

memory id. /remove a 
message 

memory. 

memory operations, 
/memchr, 

memory operations, 
memory, /lock process, 
memory segment. 



umask(2) 
master(4) 
master(4) 
regexp(5) 

math(5) 

math(5) 
matherrO) 
machid(l) 
mem(G) 

memoryO) 

memoryO) 

memoryO) 

memoryO) 

mallocO) 

mallocO) (fast 
version) 

shmctl(2) 

ipcrm(l) 

mem(6) 
memoryO) 

shmop(2) 

plock(2) 

shmget(2) 
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/memchr, memcmp, 
memcpy, 

sort: sort and/or 

files or subsequent/ 
paste: 

msgctl: 
msgop: 

exCheck: examine an ICC 
msgget: get 

or shared/ ipcrm: remove a 

exRespond: send a 
exRequest: Send a 
mesg: permit or deny 
sys nerr: system error 

and copy it to BTOS. 



lost + found directory 
for/ 

special or ordinary file. 

name: 
table. 

chmod: change 



memset: memory 
operations. 

merge files. 

merge same lines of 
several 

mesg: permit or deny 
messages. 

message control 
operations. 

message operations. 

message queue. exWait, 

message queue. 

message queue, 
semaphore set 

message to a client. 

message to a server. 

messages. 

messages, /errno, 
sys errlist, 

mkboot: reformat CENTIX 
kernel 

mkdir: make a directory. 

mkfs: construct a file 
system. 

mklost+ found: make a 

mknod: build special file. 

mknod: make a directory, 
or a 

mktemp: make a unique file 

mnttab: mounted file 
system 

mode. 



memory(3) 

sort(l) 
pasted ) 

mesg{1) 

msgctl(2) 

msgop(2) 
exwait(2) 
msgget(2) 
ipcrm(l) 

exrespond(2) 
exrequest(2) 
mesg(l) 
perror(3) 

mkboot(l) 

mkdir(l) 
mkfs(l) 

mklost+found(1) 

mknodd) 
mknod(2) 

mktempO) 
mnttab(4) 

chmodd) 



umask: set file-creation 
chmod: change 
modemcap: smart 

capability data base. 

getty: set terminal type, 

/compiler/interpreter for 

floating-point/ frexp, 
Idexp, 

touch: update access and 

utime: set file access 
and 

profile. 

uusub: 

translate byte orders to 
mount: 

system, mount, umount: 

setmnt: establish 
dismount file system. 

mnttab: 
mvdir: 

cp, In, mv: copy, link or 
Iseek: 



mode mask. 

mode of file. 

modem capability data 
base. 

modemcap: smart modem 
modes, speed, and line/ 
modest-sized programs, 
modf: manipulate parts of 

modification times of a file, 
modification times. 

monitor: prepare execution 

monitor uucp network. 

more, page: text perusal. 

Motorola/Intel, 
/swaplong: 

mount a file system. 

mount and dismount file 

mount: mount a file 
system. 

mount table. 

mount, umount: mount 
and 

mounted file system table. . 

move a directory. 

move files. 

move read/write file 
pointer. 



umasMD 
chmod(2) 
modemcap(5) 

modemcap(5) 
getty(l) 
bs(1) 
frexp(3) 

touch(l) 
utime(2) 

monitor(3) 
uusub(l) 
more(l) 
swapshort(3) 

mount(2) 
mount(l) 
mount(2) 

setmnt(l) 
mount! 1) 

mnttab(4) 
mvdir(l) 
cp(1) 
Iseektf) 
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the LP request scheduler 
and 


move request, /start/stop 


Ipsched(l) 


formatting a permuted 
index. 


mptx: the macro package 
for 


mptx(5) 


/erand48, !rand48, 
nrand48, 


mrand48, jrand48, 
srand48,/ 


drand48(3) 


operations. 


msgctl: message control 


msgctl(2) 




msgget: get message 
queue. 


msgget(2) 




msgop: message 
operations. 


msgop(2) 


tape. 


mt: interface for magnetic 


mt(6) 


package for typesetting/ 


mv: a troff macro 


mv(5) 


cp, In, 


mv: copy, link or move files. 


cp(1) 




mvdir: move a directory. 


mvdir(l) 


i-numbers. 


ncheck: generate names 
from 


ncheck(l) 


uusub: monitor uucp 


network. 


uusub(l) 


a text file. 


newform: change the 
format of 


newformO) 




newgrp: log in to a new 
group. 


newgrpd) 


news: print 


news items. 


news(1) 




news: print news items. 


news(1) 


process. 


nice; change priority of a 


nice(2) 


process by changing 


nice, /of running 


renice(l) 


priority. 


nice: run a command at low 


nice(1) 




nl: line numbering filter. 


mm 


list. 


nlist: get entries from 
name 


nlist(3) 


object file. 


nm: print name list of 
common 


nm(1) 


hangups and quits. 


nohup: run a command 
immune to 


nohup(t) 
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setjmp, longjmp: 

drand48, erand48, 
Irand48, 

null: the 



nl: line 

to/ convert: convert 

Idfcn: common 

dump selected parts of an 

Idopen, Idaopen: open a 
common 

number entries of a 
common 

Idaclose: close a common 

the file header of a 
common 

of a section of a 
common 

file header of a common 

of a section of a 
common 

header of a common 

section header of a 
common 

symbol table entry of a 
common 

symbol table entry of a 
common 

the symbol table of a 
common 

number entries in a 
common 



non-local goto. 

nrand48, mrand48, 
jrand48,/ 

null file. 

null: the null file, 
numbering filter, 
object and archive files 
object file access routines, 
object file, dump: 
object file for reading. 

object file function, /line 

object file. Idclose, 
object file. Idfhread: read 

object file, /number 
entries 

object file, /to the 
optional 

object file, /entries 

object file, /section 

object file, 
/indexed/named 

object file, /the index of a 

object file, /read an 
indexed 

object file, /seek to 
object file, linenum: line 



setjmp(3) 
drand48(3) 

null(6) 
null(6) 
nl{1) 

convert! 1) 
ldfcn(4) 
dump(l) 
ldopen(3) 

ldlread(3) 

ldclose(3) 
ldfhread(3) 

IdlseekO) 

ldohseek(3) 

IdrseekO) 

IdshreadO) 
ldsseek(3) 

IdtbindexO) 

IdtbreadO) 

IdtbseekO) 

linenum(4) 
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nm: print name list of 
common 

information for a 
common 

section header for a 
common 

information from a 
common 

entry, /symbol name for 
common 

format, syms: common 

file header for common 

directories, cpset: install 

Id: link editor for 
common 

print section sizes of 
common 

find ordering relation for 
an 

/exAllocExch, 
exDeallocExch: 

od: 

functions. 



Allocate BTOS/ ofCreate, 

interpreter for 
interactive/ 

ofOpenFile, ofCloseFile, 

Access BTOS/ 
ofOpenFile, 

BTOS file system. 



object file. 

object file, /relocation 

object file, scnhdr: 

object file, /and line 
number 

object file symbol table 

object file symbol table 
object files, filehdr: 
object files in binary 
object files. 

object files, size: 

object library, lorder: 

obtain and abandon 
exchanges. 

octal dump. 

ocurse: optimized screen 

od: octal dump. 

ofChangeFileLength, 
ofDelete: 

ofcli: command line 

ofCloseAIIFiles: Access 
BTOS/ 

ofCloseFile, 
ofCloseAIIFiles: 

of copy: copy to or from the 



nm(1) 

reloc(4) 

scnhdr{4) 

strip( 1) 

IdgetnameO) 

syms(4) 
filehdr(4) 
cpset(1) 
ld(t) 

sized ) 

lorderd) 

exchanges(2) 

od(1) 

ocurses(3) 
odd) 

ofcreatep) 
ofcli(l) 
ofopenfile(3) 
ofopenfile(3) 
of copy (1) 
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ofReadDirSector: BTOS/ 
ofDelete: Allocate BTOS/ 

o'Create, 

ofChangeFileLength, 

directory functions. 
ofCrDir, 

ofSetFileStatus: BTOS 
File/ 

directories. 

ofCloseAIIFiles: Access 
BTOS/ 

on a BTOS file. 

directory/ ofCrDir, 
ofDIDir. 

Status. ofGetFileStatus, 
ofed, 

BTOS file. ofRead, 
reading. Idopen, Idaopen: 

fopen, freopen, fdopen: 
dup: duplicate an 
open: 

writing. 

profiler, prf: 

prfdc, prfsnap, prfpr: 

memcmp, memcpy, 
memset: memory 



ofCrDir, ofDIDir, 
ofCreate, 

ofChangeFileLength, 

ofDelete: Allocate BTOS 
files. 

ofDIDir, ofReadDirSector: 
BTOS 

ofed, ofvi: edit BTOS files. 
ofGetFileStatus, 

ofls: list BTOS files and 
ofOpenFile, ofCloseFile, 

ofRead, ofWrite: 
Input/output 

ofReadDirSector: BTOS 

ofRename: rename a BTOS 
file. 

ofSetFileStatus: BTOS File 

ofvi: edit BTOS files. 

ofWrite: Input/output on a 

open a common object file 
for 

open a stream. 

open file descriptor. 

open for reading or 
writing. 

open: open for reading or 

operating system 

operating system/ 

operations, memccpy, 
memchr. 



ofdir(3) 
ofcreate(3) 

ofcreate(3) 

ofdir(3) 

ofeditors(l) 
ofstatus(3) 

ofls(1) 
ofopenfile(3) 

ofread(3) 

ofdir(3) 

ofrename(3) 

ofstatus{3) 
ofeditors(l) 
ofread(3) 
ldopen(3) 

fopen(3) 

dup(2) 

open(2) 

open(2) 
prf(6) 
profilerd) 
memory(3) 
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msgctl: message control 

msgop: message 

semctl: semaphore 
control 

semop: semaphore 

shmctl: shared memory 
control 

shmop: shared memory 
strcspn, strtok: string 

tputs: terminal 
independent 

wmop: window 
management 

join: relational database 

dcopy: copy file systems 
for 

CRT screen handling and 
o curse: 

vector,, getopt: get 

common/ Idohseek: seek 
to the 

fcntl: file control 
stty: set the 
getopt: parse command 
set parallel line printer 
object library, lorder: find 



operations, 
operations, 
operations. 

operations, 
operations. 

operations. 

operations, /strpbrk, 
strspn, 

operations, /tgetstr, tgoto, 

operations. 

operator. 

optimal access time. 

optimization package, 
curses: 

optimized screen 
functions. 

option letter from 
argument 

optional file header of a 
options. 

options for a terminal, 
options, 
options. Ipset: 
ordering relation for an 



msgctl(2) 
msgop(2) 
semctl(2) 

semop(2) 
shmctl(2) 

shmop(2) 
string(3) 

termcap(3) 

wmop(3) 

join(1) 
dcopy(l) 

curses(3) 

ocurses(3) 

getopt(3) 

ldohseek(3) 

fcntl(5) 

stty(1) 

getopt(l) 

Ipset(l) 

lorder(l) 
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a directory, or a special or 


ordinary file, mknod: make 


mknod(Z) 


dial: establish an 


out-going terminal line/ 


dial(3) 


assembler and link editor 


output, a.out: common 


a.out(4) 


long lines for finite width 


output device, fold: fold 


fold(1) 


/vsprintf: print formatted 


output of a varargs 
argument/ 


vprintf{3) 


sprintf: print formatted 


output, printf, fprintf, 


pnntt(j) 


chown: change 


owner and group of a file 


chown(2) 


chown, chgrp: change 


owner or group. 


chown(l) 


anH pvnanri flip? 


pack, peat, unpack: 
compress 


pack(1) 


handling and optimization 


package, curses: CRT 
screen 


cursesp) 


view/ mv: a troff macro 


package for typesetting 


mv(5) 


sadc: system activity 
report 


package, sal, sa2, 


sar(1) 


Qtanriarri hiiffprpri 

input/output 


package, stdio: 


stdio(3) 


interprocess 
communcation 


package (ftok). /standard 


stdipc(3) 


more. 


page: text perusal. 


more(1) 


Ipset: set 


parallel line printer 
options. 


Ipset(l) 


lp: 


parallel printer interface. 


lp(6) 


process, process group, 
and 


parent process IDs. /get 


getpid(2) 


getopt: 


parse command options. 


getopt(l) 


crup: create file system 


partition (slice). 


crup(l) 
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/endpwent, fgetpwent: 
get 

putpwent: write 
passwd: 
getpass: read a 
passwd: change login 
pwck, grpck: 

several files or 
subsequent/ 

for command. 

dirname: deliver portions 
of 

directory, getcwd: get 

fgrep: serach a file for a 

processing language, 
awk: 

signal. 

expand files, pack, 

a process, popen, 

type. mc68k, 

large files and/ pilf, dio: 

mesg: 

format, acct: 

sys — nerr: system error/ 



passwd: change login 
password. 

passwd: password file, 
password file entry. 

password file entry,. 

password file. 

password. 

password. 

password/group file 
checkers. 

paste: merge same lines of 

path: locate executable file 
path names, basename, 

path-name of current 
working 

pattern, grep, egrep, 
pattern scanning and 

pause: suspend process 
until 

peat, unpack: compress 
and 

pclose: initiate pipe 
to/from 

pdp11, u3b, vax: 
processor 

performance improvement 
in 

permit or deny messages, 
per-process accounting file 
perror, errno, sys errlist, 



passwd (1) 

passwd(4) 
getpwent(3) 

putpwent( 3) 
passwd(4) 
getpass(3) 
passwd{ 1) 
pwck(l) 

paste(l) 

path(l) 
basename (1 ) 

getcwd(3) 

grep(1) 
awk(1) 

pause(2) 

pack(l) 

popen(3) 

machid(l) 

pilf(5) 

mesg(1) 

acct(4) 

perror(3) 
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terminals, pg: file 


perusal filter for soft-copy 


pgd) 


more, page: text 


perusal. 


morel 1) 


soft-copy terminals. 


pg: file perusal filter for 


pgd) 


split: split a file into 


pieces. 


split(l) 


improvement in large 
files/ 


pilf, dio: performance 


pilflo) 


channel. 


pipe: create an 
interprocess 


pipe(2) 


tee: 


pipe fitting. 


tee(1) 


popen, pclose: initiate 


pipe to/from a process. 


popen(3) 


text, or data in/ 


plock: lock process: 


plock(2) 


intprfarp 

II IICI 1 EJl/G. 


kplot: graphics 


plot{4) 


subroutines. 


plot: graphics interface 


plot(3) 


ftell: reposition a file 


pointer in a stream, 
/rewind, 


fseek(3) 


Iseek: move read/write 
file 


pointer. 


lseek(2) 


to/from a process. 


popen, pclose: initiate pipe 


popenO) 


and library maintainor for 


portable archives, /archive 


ar(1) 


basename, dirname: 
deliver 


portions of path names. 


basenameO) 


banner: make 


posters. 


banner(l) 


logarithm, exp, log, 
loglO, 


pow, sqrt: exponential. 


exp(3) 


exp, log, loglO, 


pow, sqrt: exponential,/ 


exp(3) 


/exponential, logarithm, 


power, square root/ 


exp{3) 




pr: print files. 


prll) 


monitor: 


prepare execution profile. 


monitor{3) 


cpp: the C language 


preprocessor. 


cppd) 


unget: undo a 


previous get of an SCCS 


unget(l) 



file. 
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Profiler- prf: operating system prf{6) 

prfld, prfstat, prfdc, prfsnap, prfpr:/ profiler(l) 

prfsnap, prfpr:/ prfld, prfstat, prfdc, profiler! 1) 

/prfstat, prfdc, prfsnap, prfpr: operating system/ profiler! 1) 

prfld, prfstat, prfdc, prfsnap, prfpr:/ profiler(l) 

prfpr: operating/ prfld, prfstat, prfdc, prfsnap, profiler! 1) 

Wpes: primitive system data types(S) 
types. 

window: window primitives. window(6) 
managment 

P rs: print an SCCS file. prs(1) 

d ate: print and set the date. dated) 

number, apnum: print Application Processor apnum(l) 

cal: print calendar. cal(1) 

of a file, sum: print checksum and block sum(1) 
count 

editing activity, sact: print current SCCS file sact(1) 

cat: concatenate and print files. cat(1) 

P r: print files. pr(1) 

vprintf, vfprintf, vsprintf: print formatted output of a/ vprintf(3) 

printf, fprintf, sprintf: print formatted output. printf(3) 

!P stat: print LP status Ipstat(l) 
information. 

object file, nm: print name list of common nm(1) 

uname: print name of system. uname(l) 

news: print news items. news(1) 

object files, size: print section sizes of sized) 
common 
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names, id: 
Ip: parallel 

requests to an LP line 

Ipset: set parallel line 
Ipr: line 

disable: enable/disable 
LP 

print formatted output. 

nice: run a command at 
low 

nice: change 

process/ renice: alter 

acct: enable or disable 

alarm: set a 

times, times: get 

/priority of running 

init, icode, telinit: 

timex: time a command; 
report 

exit, exit: terminate 

fork: create a new 

/getpgrp, getppid: get 
process, 

setpgrp: set 

process group, and 
parent 

inittab: script for the init 
kill: terminate a 



print user and group IDs and 

printer interface. 

printer, /cancel: 
send/cancel 

printer options. 

printer spooler. 

printers, enable, 

printf, fprintf, sprintf: 
priority. 

priority of a process, 
priority of running 
process accounting, 
process alarm clock, 
process and child process 
process by chanaging/ 
process control/ 
process data and system/ 

process, 
process. 

process group, and 
parent/ 

process group ID. 
process IDs. /get process, 

process, 
process. 



id{1) 
lp(6) 
lp(D 

Ipsetd) 

lpr(1) 

enable(l) 

printf(3) 
nice(l) 

nice(2) 

renice(t) 

acct(2) 

alarm(2) 

times(2) 

renice) 1) 

init(l) 

timexd) 

exit(2) 
fork(2) 
getpidtf) 

setpgrp(2) 
getpid(2) 

inittab(4) 
killd) 



1192192 



lndex-74 



nice: change priority of a 

Application/ spawn: 
execute a 

spawnlp, spawnvp. 
execute a 

kill: send a signal to a 

initiate pipe to/from a 

getpid, getpgrp, getppid: 
get 

ps: report 

in memory, plock: lock 

times: get process and 
child 

wait: wait for child 



pause: suspend 

wait: await completion 
of 

list of file systems 



to a process or a group of 

killall: kill all active 

awk: pattern scanning 
and 

shutdown, halt: 
terminate all 

m4: macro 

apnum: print Application 

console: control 
Application 



process. 

process on a specific 

process on a specific/ 

process or a group of/ 

process, popen, pclose: 

process, process group, 
and/ 

process status, 
process, text, or data 
process times. 

process to stop or 
terminate. 

process until signal, 
process. 

processed by fsck. 
checklist: 

processes, /send a signal 
processes. 

processing language. 

processing. 

processor. 
Processor number. 
Processor pseudoconsole. . 



nice(2) 
spawn(l) 

spawn (3) 

kill(2) 

popen(3) 

getpid(2) 

ps(l) 

plock(2) 

times(2) 

wait(2) 

pause(2) 
wait(1) 

checklist^) 

kill{2) 

killall(l) 

awk(1) 

shutdown! 1) 

m4(1) 

apnum(1) 

console(l) 
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ICC statistics for 


processor, pstat: 


pstat(l) 


on a specific Applicator) 


Processor, /execute a 
process 


spawn! 1) 


on a specific Application 


Processor, /execute a 
process 


spawn(3) 


activity/ fpsar: File 


Processor system 


fpsar(l) 


mc68k, prjpll, u3b, vax: 


processor type. 


machid(l) 




prof: display profile data. 


prof (11 


function. 


prof: profile within a 


prof(5) 


profile. 


profil: execution time 


profil(2) 


prof: display 


profile data. 


prof(1) 


monitor: prepare 
execution 


profile. 


monitor(3) 


profil: execution time 


profile. 


profil(2) 


environment at login 
time. 


profile: setting up an 


profiled) 


prof: 


profile within a function. 


prof(5) 


prf: operating system 


profiler. 


prf(B) 


prfpr: operating system 


profiler, /prfsnap, 


prof iler(1) 


sadp: disk access 


profiler. 


sadp(1) 


standard/restricted 
command 


programming language, 
/the 


snf,l) 


update: 


provide disk 
synchronization. 


updated) 


/pdpll, u3b, u3b5, vax 


provide truth value/ 


machidd) 


true, false: 


provide truth values. 


trued) 




prs: print an SCCS file. 


prs(1) 




ps: report process staus. 


ps(D 


control Application 


pseudoconsole. console: 


consoled) 



Processor 
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/generate uniformly 
distributed 

(or processor. 

download, tdl, gtdl, 



stream, ungetc: 

put character or word on 
a/ 

character or word on a/ 
putc, 

environment. 

entry. 

stream. 

getutent, getutid, 
getutline, 

a/ putc, putchar, fputc, 
file checkers. 



BTOS queue, 
tput: 

examine an ICC message 
msgget: get message 
add a new entry to a BTOS 



pseudo-random numbers. 

pstat: ICC statistics 

ptdl: RS-232 terminal 

ptrace; process trace. 

ptx: permuted index. 

push character back into 
input 

putc, putchar, fputc, 
putw: 

putchar, fputc, putw: put 

putenv: change or add 
value to 

putpwent: write password 
file 

puts, fputs: put a string 
on a 

pututline, setutent, 
endutent,/ 

putw: put character or 
word on 

pwck, grpck: 
password/group 

pwd: working directory 
name. 

qsort: quicker sort. 

quAdd: add a new entry 
to a 

query temrinfo database, 
queue. exWait, exCheck: 
queue. 

queue. quAdd: 



drand48(3) 

pstat(l) 

tdl(1) 

ptrace(2) 

PU(1) 

ungetc(3) 

putc(3) 

putc(3) 

putenv(3) 

putpwent(3) 

puts(3) 

getut(3) 

putc(3) 

pwck(1) 

pwd(1) 

qsort(3) 
quadd(3) 

tput(l) 
exwait(2) 
msgget(2) 
quadd(3) 



quReadKeyed: examine 
BTOS 

quRemove: take back a 
BTOS 

ipcrm: remove a message 
qsort: 

command immune to 
hangups and 

queue. quReadNext, 

examine BTOS queue, 
queue request. 

random-number 
generator. 

rand, srand: simple 

fsplit: split fortran, 

initiaiization/brc. 
bcheckrc, 

getpass: 

entry of a common/ 
Idtbread: 

header/ Idshread, 
Idnshread: 

read: 

rmail: send mail to users or 
line: 

member of an/ Idahread: 

common object file. 
Idfhread: 



queue. quReadNext, 

queue request. 

queue, semaphore set or 
shared/ 

quicker sort. 

quits, nohup: run a 

quReadKeyed: examine 
BTOS 

quReadNext, quReadKeyed: 

quRemove: take back a 
BTOS 

rand, srand: simple 

random-number generator, 
ratfor, or efl files, 
rc, allrc, conrc: system 

read a password. 

read an indexed symbol 
table 

read an indexed/named 
section 

read from file, 
read mail, mail, 
read one line, 
read: read from file, 
read the archive header of a 
read the file header of a 



quread(3) 

quremove(3) 

ipcrmO) 

qsort(3) 
nohupd) 

quread(3) 

quread(3) 
quremove(3) 

rand(3) 

rand{3) 
fsplitd) 
brc(1 | 

getpass(3) 
ldtbread(3) 

ldshread(3) 

read(2) 

mail(1) 

lined) 

read(2) 

ldahread(3) 

ldfhread(3) 
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open a common object 
file for 

open: open for 
Iseek: move 
allocator, malloc, free. 



mallinfo: fast/ malloc, 
free, 

specify what to do upon 
lockf: 

manipulate connect 
accounting 

tape, free: 
ed, 

it to BTOS. mkboot: 

execute regular 
expression. 

expression compile. 

make: maintain, update, 
and 

regular expression, 
regemp, 

compile and match 
routines. 

locking: exclusive access 
to 

match routines, regexp: 



regemp: 

regex: compile and 
execute 

requests, accept. 



reading. Idopen, Idaopen: 

reading or writing. 

read/write file pointer. 

realloc, calloc: main 
memory 

realloc, calloc, mallopt, 

receipt of a signal, signal: 
record locking on files, 
records, fwtmp, wtmpfix: 

recover files from a 
backup 

red: text editor. 

reformat CENTIX kernel 
and copy 

regemp, regex: compile 
and 

regemp: regular 

regenerate groups of 
programs. 

regex: compile and 
execute 



regexp: regular expression 



regions of a file. 



regular expression compile 
and 

regular expression 
compile. 

regular expression, 
regemp, 

reject: allow/prevent LP 



ldopen(3) 

open{2) 
lseek(2) 
malloc(3) 

malloctf) (fast 
version) 

signal(2) 

lockfO) 

fwtmp(l) 

freed ) 

ed{1) 
mkboot(l) 

regcmp(3) 

regcmp(l) 
make(l) 

regcmp(3) 

regexp(5) 

locking(2) 

regexp(5) 

regempd) 

regemp (3) 

accept! 1) 
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sorted files, comm: 
select or 


reject lines common two 


comm(1) 


lorder: find ordering 


relation for an object/ 


lorder(l) 


join: 


relational database 
operator. 


join(1) 


for a common object file. 


reloc: relocation 
information 


reloc(4) 


Idrseek, Idnrseek: seek to 


relocation entries of a/ 


ldrseek(3) 


common object file, 
reloc: 


relocation information for a 


reloc(4) 


/fmod, fabs: floor, 
ceiling. 


remainder, absolute value/ 


floor(3) 


calendar. 


reminder service. 


calendar! 1) 


ct: spawn getty to a 


remote terminal. 


ct(1) 


file, rmdel: 


remove a delta from an 


rmdeKD 


semaphore set or/ ipcrm: 


remove a message queue, 


ipcrm(l) 


unlink: 


remove directory entry. 


nnlinli(7) 


rm, rmdir: 


remove rues ur uiibliuiico. 


rm(1) 


ofRename: 


rename a BTOS file. 


ofrenamep) 


of running process by/ 


renice: alter priority 


reniced) 


check and interactive 


repair, /system 
consistency 


fsck(1) 


uniq: report 


repeaxeu lines in a inc. 


iininfl \ 


clock: 


report i»ru lime uaeu. 


clock! 3) 


communication/ ipcs: 


report inter-process 


ipcs(l) 


blocks, df: 


report number of free disk 


df(1) 


dDL, Nub. oyoioni 

activity 


report package, sal, 


sar(1) 


timex: time a command; 


report process data and 
system/ 


timexd) 
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ps: 


report process status. 


ps(1) 


file, uniq: 


report repeated lines in a 


uniq(1) 


system activity 


reporter. /Processor 


fpsarU) 


sar: system activity 


reporter. 


sar(1) 


stream, fseek, rewind, • 
hell: 


reposition a file pointer in a 


fseek(3) 


reponse. exCall: Send a 


request and wait for the 


excall(2) 


exServeRq: appropriate a 


request code. 


exserverq(2) 


take back a BTOS queue 


request. quRemove: 


quremove(3) 


/Ipmove: start/stop the 
LP 


request scheduler and 
move/ 


ipsched(l) 


reject: allow/prevent LP 


requests, accept, 


accept! 1) 


exCnxSendOnDeal 
loc: make final 


request. exSendOnDealloc, 


exfinal(2) 


LP request scheduler and 
move 


requests, /start/stop the 


Ipsched(l) 


service spawn execution 


requests, spawnsrv: 


spawnsrv(l) 


syslocal: special system 


requests. 


syslocal{2) 


lp, cancel: send/cancel 


requests to an LP line/. 


IpID 


a request and wait for the 


response. exCall: Send 


excall(2) 


common object file/ 
Idgetname: 


retrieve symbol name for 


ldgetname(3) 


abs: 


return integer absolute 

value 


abs(3) 


logname: 


return login name of user. 


lognameO) 


name, getenv: 


return value for 
environment 


getenv(3) 
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stat: data 


returned by stat system 
call. 


stat(5) 


col: filter 


reverse line-feeds. 


cold) 


file pointer in a/ fseek. 


rewind, hell: reposition a 


fseek(3) 


creat: create a new file or 


rewrite an existing one. 


creat(2) 


directories. 


rm, rmdir: remove files or 


rm(1) 


read mail, mail, 


rmail: send mail to users or 


mail(l) 


SCCS file. 


rmdel: remove a delta 
from an 


rmdel(l) 


directories, rm, 


rmdir: remove files or 


rm(1) 


chroot: change 


root directory. 


chroot(2) 


chroot: change 


root directory for a 
command. 


nkrnnW 1 \ 

enroou if 


logarithm, power , square 


root functions, 
/exponential. 


expldj 


common object file 
access 


routines. Idfcn: 




expression compile and 
match 


routines, regexp: regular 


regexp(5) 


controlling terminal's 
local 


RS-232 channels, tp: 


tp(6) 


tdl: 


rs232 terminal download. 


tdl(1) 


standard/restricted/ sh, 


rsh: shell, the 


sh(1) 


nice: 


run a coninianu di iuw 
priority. 


nirpM \ 


hangups and quits, 
nohup: 


run a command immune to 


nohup(l) 


/alter priority of 


running process by/ 


renice(1) 


activity report package. 


sal, sa2, sadc: system 


sar(1) 


report package, sal, 


sa2, sadc: system activity 


sar(1) 


editing activity. 


sact: print current SCCS file 


sact(1) 


package, sal, sa2, 


sadc: system activity 
report 


sard) 
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profiler. 

graph. 

reporter. 

space allocation, brk, 
formatted input, 
bfs: big file 

language, awk: pattern 

the delta commentary of 
an 

comb: combine 

make a delta {change) to 
an 

sact: print current 

get: get a version of an 

prs: print an 

rmdel: remove a delta 
from an 

compare two versions of 
an 

sccsfile: format of 

undo a previous get of an 

val: validate 

admin: create and 
administer 

what: identify 

of an SCCS file. 



sar: system activity 
reporter. 

sadp: disk access 

sag: system activity 

sar: system activity 

sbrk: change data 
segment 

scanf, fscanf, sscanf: 
convert 

scanner. 

scanning and processing 
SCCS delta, ede: change 

SCCS deltas. 
SCCS file, delta: 

SCCS file editing activity. 
SCCS file. 
SCCS file. 
SCCS file. 

SCCS file, sccsdiff: 

SCCS file. 
SCCS file, unget: 
SCCS file. 
SCCS files. 

SCCS files. 

sccsdiff: compare two 
versions 



sar(l) 

sadp(1) 
sag(l) 
sar(1) 
brk(2) 

scanf(3) 

bfs(1) 

awk(1) 

cdc(l) 

comb(l) 
delta(l) 

sact(1) 
get(1) 
prs(1) 
rmdeld) 

sccsdiff (1) 

sccsfile(4) 
unget(1) 
val(1) 
admind) 

whatd) 
sccsdiff (1) 
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/start/stop the LP 
request 

common object file. 

clear: clear terminal 

ocurse: optimized 

optimization/ curses: 
CRT 

display editor based on/ 
vi: 

inittab: 

terminal session, 
system initialization shell 

program. 

grep, egrep, fgrep: 

bsearch: binary 

Isearch, Kind: linear 

hcreate, hdestroy: 
manage hash 

tdelete, twalk: manage 
binary 

object file, scnhdr: 

object/ /read an 
indexed/named 

/to line number entries 
of a 

/to relocation entries of a 

/seek to an 
indexed/named 



sccsfile: format of SCCS 
file. 

scheduler and move 
requests. 

scnhdr: section header for a 
screen. 

screen functions, 
screen handling and 

screen-oriented (visual) 

script for the init process. 

script: make typescript of 

scripts, /rc, allrc, conrc: 

sdb: symbolic debugger. 

sdiff: side-by-side 
difference 

search a file for a pattern 
search a sorted table, 
search and update, 
search tables, hsearch, 

search trees, tsearch, 
tfind. 

section header for a 
common 

section header of a 
common 

section of a common 
object/ 

section of a common 
object/ 

section of a common 
object/ 



sccsfile(4) 
Ipschedd) 

scnhdr(4) 
clear! 1) 
ocurse(3) 
curses(3) 

vi(1) 

inittab(4) 
script(l) 
brc(1) 
sdb(1) 
sdiff (1) 

grepd) 
bsearchp) 
lsearch(3) 
hsearch(3) 

tsearch(3) 

scnhdr(4) 

ldshread(3) 

ldlseek(3) 

ldrseek(3) 

ldsseek(3) 
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files, size: print 

/mrand48, jrand48, 
sranrJ48, 

section of/ Idsseek, 
Idnsseek: 

a section/ Idlseek, 
Idnlseek: 

a section/ Idrseek, 
Idnrseek: 

header of a common/ 
Idohseek: 

common object file. 
Idtbseek: 

shmget: get shared 
memory 

brk, sbrk: change data 

to two sorted files, 
comm: 

of a file, cut: cut out 
file, dump: dump 
semctl: 

semop: 

ipcrm: remove a message 
queue, 

semget: get set of 
operations. 



exRespond: 



section sizes of common 
object 

sed: stream editor. 

seed48, lcong48: 
generate/ 

seek to an indexed/named 

seek to line number 
entries of 

seek to relocation entries of 

seek to the optional file 

seek to the symbol table 
of a 

segment. 

segment space allocation. 

select or reject lines 
common 

selected fields of each line 

selected parts of an object 

semaphore control 
operations. 

semaphore operations. 

semaphore set or shared 
memory/ 

semaphores. 

semctl: semaphore control 

semget: get set of 
semaphores. 

semop: semaphore 
operations. 

send a message to a 
client. . 



sized) 

sed(1) 
drand48(3) 

ldsseek(3) 

ldlseek(3) 

Idrseekp) 

ldohseek(3) 

ldtbseek(3) 

shmget(2) 

brk(2) 
comm(l) 

cut(1) 

dumpd) 

semctl(2) 

semop(2) 
ipcrmd) 

semget(2) 
semctl(2) 
semget(2) 

semop(2) 

exrespond{2) 
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exRequest: 

the response. exCall: 
a group of processes, kill: 
mail, mail, rmail: 
line printer. Ip, cancel: 

aliases file for 

exRequest: Send a 
message to a 

make typescript of 
terminal 

buffering to a stream 

IDs. setuid, 

getgrent, getgrgid, 
getgrnam, 

goto. 

encryption, crypt, 



getpwent, getpwuid, 
getpwnam, 

environment/ cprofile: 
login time, profile: 

gettydefs: speed and 
terminal 

group IDs. 



Send a message to a 
server. 

Send a request and wait for 

send a signal to a process or 

send mail to users or read 

send/cancel requests to 
an LP 

sendmail. aliases: 
server. 

session, script: 

setbuf, setvbuf: assign 

setgid: set user and group 

setgrent, endgrent, 
fgetgrent:/ 

setjmp, longjmp: non-local 

setkey, encrypt: generate 
DES 

setmnt: establish mount 
table. 

setpgrp: set process group 
ID. 

getpwent, endpwent, 
f getpwent:/ 

setting up a C shell 

setting up an environment 
at 

setting used by getty. 
setuid, setgid: set user and 



exrequest(2) 

excall(2) 
killtf) 
mail(l) 
lp(1) 

aliases(5) 
exrequest(2) 

script( 1) 

setbuf(3) 
setuid(2) 
getgrent(3) 

setjmp(3) 
crypt(3) 

setmnt(l) 

setpgrp(2) 

getpwentp) 

cprofile(4) 
profile(4) 

gettydefs(4) 

setuid(2) 
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/getutid, getutline, 
pututline, 

stream, setbuf, 

data in a/ sputl, 

standard/restricted 
command/ 

operations, shmctl: 

queue, semaphore set or 

shmop: 

shmget: get 

system: issue a 

cprofiie: setting up a C 

conrc: system 
initialization 

command programming/ 
sh, rsh: 

operations. 

segment. 

operations, 
processing. 

program, sdiff: 
login: 

pause: suspend process 
until 

whaqt to do upon receipt 
of a 

upon receipt of a signal. 



setuname: set name of 
system. 

setutent, endutent, 
utmpname:/ 

setvbuf: asign buffering to a 
sgetl: access long integer 
sh, rsh: shell, the 

shared memory control 

shared memory id. /a 
message 

shared memory operations, 
shared memory segment, 
shell command, 
shell environment at/ 
shell scripts, /rc, allrc, 

shell, the 

standard/restricted 

shmctl: shared memory 
control 

shmget: get shared 
memory 

shmop: shared memory 

shutdown, halt: terminate 
all 

side-by-side difference 

sign on. 

signal. 

signal, signal: specify 
signal: specify what to do 



setuname(l) 

getut(3) 

setbuf(3) 

sputl(3) 

sh(1) 

shmctl(2) 
ipcrm(l) 

shmop(2) 
shmget(2) 
system(3) 
cprofiie (4) 
brc(1) 

sh(1) 

shmctl(2) 

shmget(2) 

shmop(2) 
shutdown(l) 

sdiff (1) 
login(l) 
pause(2) 

signal(2) 

signal(2) 
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of processes, kill: send a 



sslgnal, gsignal: software 

lex: generate programs 
for 

generator, rand, srand: 

atan, atan2: 
trigonometric/ 

functions. 



fsize: calculate file 
common object files 
size: print section 

an interval. 

interval. 

create file system 
partition 

the/ ttyslot: find the 
current/ ttyslot: find the 
base, modemcap: 

pg: file perusal filter for 
ssignal, gsignal: 
sort: 

qsort: quicker 



signal to a process or a 
group 

signals. 

sigmple lexical tasks. 

simple random-number 
sin, cos, tan, asin, acos, 

sinh, cosh, tanh: 
hyperbolic 

size. 

size: print section sizes of 

sizes of common object 
files. 

sleep: suspend execution 
for 

sleep: suspend execution 
for 

(slice), crup: 

slot in the utmp file of 

slot in the utmp file of the 

smart modem capability 
data 

soft-copy terminals, 
software signals, 
sort and/or merge files, 
sort. 

sort: sort and/or merge 
files. 



kill(2) 

ssignal(3) 
lex(1) 

rand(3) 
trig(3) 

sinh(3) 

fsize(l) 
size(l) 
size(t) 

sleep! 1) 

sleep(3) 

crup(1) 

mv(5) 

ttyslot(3) 

modemcap(5) 

pgO) 

ssignal(3) 
sort(1) 
qsort(3) 
sort(l) 



tsort: topological 



sort. 



tsortd) 
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or reject lines common 
to two 

bsearch: binary search a 

brk, sbrk: change data 
segment 

specific Application/ 



spawnsrv: service 

terminal, ct: 

process on a specific/ 

execution requests, 
a specific/ spawnlp, 

spawn: execute a 
process on a 

execute a process on a 

fspec: format 

receipt of a signal, 
signal: 

/set terminal type, 
modes, 

used by getty. gettydefs: 

hashcheck: find spelling/ 

spelling/ spell, 
hashmake, 

spellin, hashcheck: find 
split: 

csplit: context 
efl files, fsplit: 



sorted files, comm: select 

sorted table, 
space allocation. 

spawn: execute a process 
on a 

spawn execution requests. 

spawn getty to a remote 

spawnlp, spawnvp: 
execute a 

spawnsrv: service spawn 

spawnvp: execute a 
process on 

specific Application/ 

specific Application/ 
/spawnvp: 

specification in text files, 
specify what to do upon 

speed, and line discipline. 

speed and terminal 
settings 

spell, hashmake, spellin, 
spellin, hashcheck: find 

spelling errors, 
/hashmake, 

split a file into pieces. 

split. 

split fortran, ratfor, or 



comm(l) 

bsearch(3) 
brk(2) 

spawn) 1) 

spawnsrv! 1) 

ct{1) 

spawn(3) 

spawnsrvd) 
spawn(3) 

spawn! 1) 

spawn(3) 

fspec(4) 
signal(2) 

getty(l) 

gettydefs(4) 

spell(l) 
spell(1 ) 

spelld) 

split! 1) 
csplit (1) 
fsplit(l) 
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pieces. 


split: split a file into 


split(i) 


uuclean: uucp 


spool directory clean-up. 


I /4 \ 

uclean(l) 


Ipr: line printer 


spooler. 


1 / 4 V 

Ipr(l) 


Ipadmin: configure the LP 


spooling system. 


Ipadmin(l) 


output, printf, fprintf, 


sprintf: print formatted 


printf(3) 


integer data in a/ 


sputl, sgetl: access long 


sputl(3) 


nnwpr / pxn Ion Ion 10 
pow, 


sqrt: exponential, 
logarithm, 


exp(3) 


ovnnnontial Innanthm 
cXpUl IcIlUdl, lULJdl Hill II, 

power 


cm t art* rnnt fimrtinnQ 

/sqrt: 


pvn(3) 


generator, rand, 


srand: simple 
random-number 


rand(3) 


nrand48, mrand48, 
jrand48, 


srand48, seed48, 
lcong48:/ 


drand48(3) 


input, scanf, fscanf, 


sscanf: convert formatted 


scanf(3) 


signals. 


ssignal, gsignal: software 


ssignal(3) 


narkane stdio' 


standard buffered 
input/output 


stdio(3) 


fnmmiiniratinn narkanp/ 
stdipc: 


standard interprocess 


stdipc(3) 


sh, rsh: shell, the 


standard/restricted 
command/ 


sh(1| 


Ipsched, Ipshut, Ipmove: 


start/stop the LP request/ 


lpsched(1) 


system call. 


stat: data returned by stat 


. . /f-\ 

stat(b) 




stat, fstat: get file status. 


stat(2) 


stat: data returned by 


stat system call. 


stat(5) 


ff: list file names and 


statistics for a file 
system. 


ff(1) 


processor, pstat: ICC 


statistics for 


pstat(1) 


ustat: get file system 


statistics. 


ustat(2) 
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Ipstat: print LP 

feof, clearerr, fileno: 
stream 

control, uustat: uucp 
communication facilities 

ofSetFileStatus: BTOS 
File 

ps: report process 
stat, fstat: get file 
input/output package. 

wait for child process to 

strncmp, strcpy, 
strncpy,/ 

/strcpy, strncpy, strlen, 

strncpy,/ strcat, strncat, 

/strncat, strcmp, 
strncmp, 

/strrchr, strpbrk, strspn, 
sed: 

fflush: close or flush a 

fopen, freopen, fdopen: 
open a 

reposition a file pointer 
in a 

get character or word 
from a 

fgets: get a string from a 



status information, 
status inquiries, (error, 

status inquiry and job 

status, /report 
inter-process 

Status. ofGetFileStatus. 

status, 
status. 

stdio: standard buffered 
stime: set time, 
stop or terminate, wait: 
strcat, strncat, strcmp, 

strchr, strrchr, strpbrk,/ 
strcmp, strncmp, strcpy, 
strcpy, strncpy, strlen,/ 

strcpn, strtok: string/ 
stream editor, 
stream, fclose, 
stream. 

stream, fseek, rewind, 
ftell: 

stream, /getchar, fgetc, 
getw: 

stream, gets. 



Ipstatd) 
ferror(3) 

uustat{1) 
ipcs(1) 

ofstatusO) 

ps(1) 

stat(2) 

stdioO) 

stime(2) 

wait(2) 

stringO) 

stringO) 
stringO) 
stringO) 

stringO) 
sed(1) 
fclose(3) 
fopenO) 

fseekO) 

getcO) 

getsO) 
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put character or word on a stream, /putchar, fputc, putc(3) 
putw: 

puts, (puts: put a string stream. puts(3) 
on a 

setvbuf: assign buffering stream, setbuf, setbuf(3) 
to a 

/feof, clearerr, fileno: stream status inquiries. ferror(3) 

push character back into stream, ungetc: ungetc(3) 
input 

long integer and base-64 string. /164a: convert a64l(3) 

ASCII between 

convert date and time to string, /asctime, tzset: ctime(3) 

floating-point number to string, /fcvt, gcvt: convert ecvt(3) 

gets, fgets: get a string from a stream. gets{3) 

puts, fputs: put a string on a stream. puts(3) 

strspn, strcspn, strtok: string operations. string(3) 
/strpbrk, 

number, strtod, atof: string to double-precision strtod(3) 
convert 

number, atof: convert string to floating-point atof (3) 
ASCII 

strtol, atol, atoi: convert string to integer. strtol(3) 

line number information/ strip: strip symbol and strip(l) 

number/ strip: strip symbol and line strip(l) 

strncmp, strcpy, strncpy, strlen, strchr, strrchr,/ string(3) 

strcpy, strncpy,/ strcat, strncat, strcmp, strncmp, string(3) 

strcat, strncat, strcmp, strncmp, strcpy, strncpy,/ string(3) 

strcmp, strncmp, strcpy, strncpy, strlen, strchr,/ string(3) 
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/strlen, strchr, strrchr, strpbrk, strspn, strcspn,/ string(3) 

strncpy, strlen, strchr, strrchr, strpbrk, strspn,/ string(3) 

strchr, strrchr, strpbrk, strspn, strcspn, strtok:/ string(3) 

to double-precision strtod, atof: convert string strtod(3) 

number. 

/strpbrk.strspn, strcspn, strtok: string operations. string(3) 

string to integer. strtol, atol, atoi: convert strtol(3) 

terminal. stty: set the options for a stty(l) 

another user. su: become super-user or su(1) 

intro: introduction to subroutines and libraries. intro(3) 

plot: graphics interface subroutines. plot(3) 

/same lines of several subsequent lines of one file. pasted ) 

files or 

count of a file. sum: print checksum and sum(1) 

block 

/ 

du: summarize disk usage. du(1) 

sync: update the super block. sync(1) 

sync: update super-block. sync(2) 

su: become super-user or another su(1) 

user. 

interval, sleep: suspend execution of an sleep! 1) 

interval, sleep: suspend execution for sleep{3) 

pause: suspend process until pause(2) 

signal. 

swab: swap bytes. swab(3) 

swab: swap bytes. swab(3) 

orders to/ swapshort, swaplong: translate byte swapshort(3) 

byte orders to/ swapshort, swaplong: swapshort(3) 

translate 



file. 

information from/ strip: 
strip 

file/ Idgetname: retrieve 

name for common object 
file 

object/ /compute the 
index of a 

Idtbread: read an indexed 

syms: common object file 

object/ Idtbseek: seek to 
the 

sdb: 

symbol table format. 



update: provide disk 
swrite: 

error/ perror, errno, 

requests. 

perror, errno, 
sys errlist, 

binary search a sorted 

for common object file 
symbol 

/compute the index of a 
symbol 



swrite: synchronous write 
on a 

symbol and line number 

symbol name for common 
object 

symbol table entry, 
/symbol 

symbol table entry of a 
common 

symbol table entry of a 
common/ 

symbol table format, 
symbol table of a common 

symbolic debugger. 

syms: common object file 

sync: update super-block 

sync: update the super 
block. . 

synchronization. 

synchronous write on a 
file. . 

sys errlist, sys nerr: 

system 

syslocal: special system 
sys nerr: system error/ 

table, bsearch: 

table entry, /symbol name 

table entry of a common 
object/ 



swrite(2) 

strip! 1) 

IdgetnameO) 

ldgetname(3) 

ldtbindex(3) 

IdtbreadO) 

syms(4) 
ldtbseek(3) 

sdb{1) 
syms(4) 
sync(2) 
sync(1) 

update(l) 
swrite(2) 

perror(3) 

syslocal(2) 
perror(3) 

bsearch(3) 
ldgetname(3) 

ldtbindex(3) 
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file, /read an indexed 
symbol 

common object file 
symbol 

master device information 

mnttab: mounted file 
system 

Idtbseek: seek to the 
symbol 

setmnt: establish mount 

hdestroy: manage hash 
search 

tabs: set 



expand, unexpand: 
expand 

a file. 

request. quRemove: 
trigonometric/ sin, cos, 

sinh, cosh, 
tar: 

recover files from a 
backup 

mt: interface for 
magnetic 



programs for simple 
lexical 

search trees, tsearch, 
tfind 



table entry of a common 
object 

table format, syms: 



table, master: 
table. 

table of a common object 
file. 

table. 

tables, hsearch, hcreate, 

tabs on a terminal. . 

tabs: set tabs on a 
terminal. 

tabs to spaces, and vice/ 

tail: deliver the last part of 

take back a BTOS queue 

tan, asin, acos, atan, 
atan2: 

tanh: hyperbolic functions, 
tape file archiver. 
tape, free: 

tape. 

tar: tape file archiver. 
tasks, lex: generate 

tdelete, twalk: manage 
binary 

tdl: rs232 terminal 
download. 



Idtbread{3) 

syms(4) 

master(4) 
mnttab(4) 

ldtbseek(3) 

setmntd) 
hsearch(3) 

tabs(l) 
tabs(1) 

expand(l) 

tail(l) 

quremove(3) 
trig(3) 

sinh(3) 
tar(1) 
freed ) 

mt<6) 

tar(1) 
lex(1) 

tsearch(3) 

tdld) 
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initialization, init, icode, 
temporary file, tmpnam, 

tmpfile: create a 

tempnam: create a name 
for a 



tee: pipe fitting. 

telinit: process control 

tempnam: create a name 
for a 

temporary file, 
temporary file, tmpnam, 



tee(1) 
init(1) 
tmpnam(3) 

tmpfile(3) 
tmpnam(3) 



terminals. 


term: conventional names 
for 


term{5) 


term, format of compiled 


term file. . 


term(4) 


file. 


term: format of compiled 
term 


term (4) 


data base. 


termcap: terminal 
capability 


termcap(4) 


termcap: 


terminal capability data 
base. . 


termcap (4) 


terminfo: 


terminal capability data 
base. 


terminfo(4) 


console: console 


terminal. 


rnncfilnifii 


ct: spawn getty to a 
remote 


torminal 

leriniiidi. 


ctll) 


generate file name for 


terminal, ctermid: 


rtarmini 1 1 
CloiillluV 0/ 


tdl: rs232 


terminal download. 


tdl(1) 


/terminal interface, and 


terminal environment. 


tset(1) 


/tgetstr, tgoto, tputs: 


terminal independent/ 


termcap(3) 


terminal/ tset: set 
terminal. 


terminal interface, and 


tset(1) 


termio: general 


terminal interface. 


termio(6) 


tty: controlling 


terminal interface. 


tty(6> 


dial: establish an 


terminal line connection. 


dial{3) 


out -going 
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clear: clear 


terminal screen. 


clear (11 


script: make typescript of 


terminal session. 


script) 1) 


getty. gettydefs: speed 
and 


terminal settings used by 


gettydefs(4) 


stty: set the options for a 


terminal. 


sttyd) 


tabs: set tabs on a 


terminal. 


tabsd) 


and terminal/ tset: set 


terminal, terminal 
interface, 


tset(1) 


tty: get the name of the 


terminal. 


tty(1) 


isatty: find name of a 


terminal, ttyname, 


ttyname(3) 


and line/ getty: set 


terminal type, modes, 
speed, 


getty (1) 


vt: virtual 


terminal. 


vt(6) 


channels, tp: controlling 


terminal s local Rb-ZJZ 


tp(6) 


perusal filter for 
soft-copy 


terminals, pg: file 


pg(D 


term: conventional names 
for 


terminals. 


term(b) 


wmlayout: get 


terminal's window layout. 


wmlayout! 3) 


kill: 


terminate a process. 


kill(1) 


shutdown, halt: 


terminate all processing. 


shutdown! 1) 


exit, exit: 


terminate process. 


exit(2) 


for child process to stop or 


terminate, wait: wait 


wait(2) 


tic: 


terminfo compiler. 


tic(1) 


tput: query 


terminfo database. 


tputd) 


tic; 


terminfo compiler. 


terminfo(4) 


interface: 


termio: general terminal 


termio{6) 


command. 


test: condition evaluation 


testd) 


ed, red: 


text editor. 


edd) 



ex: 

ex for casual/ edit: 

change the format of a 

fspec: format 
specification in 

piock: lock process 

more, page: 

strings: extract the 
ASCII 

binary search types, 
tsearch, 

tgetstr, tgoto, tputs:/ 

tputs:/ tgetent, tgetnum, 

tgoto, tputs:/ tgetent, 

tgetent, tgetnum, 
tgetflag, 

/tgetnum, tgetflag, 
tgetstr, 

data and system/ timex: 
time: 

commands at a later 

environment at login 

systems for optimal 
access 

profit: execution 

up an environment at 
login 



text editor. ex(1) 

text editor (variant of edit(1) 

text file, newform: newform(l) 

text files. fspec(4) 

text, or data in memory. plock(2) 

text persual. more(l) 

text strings in a file. strings(l) 

tfind, tdelete, twalk: tsearch(3) 
manage 

tgetent, tgetnum, tgetflag, termcap(3) 

tgetflag, tgetstr, tgoto, termcap(3) 

tgetnum, tgetflag, tgetstr, termcap(3) 

tgetstr, tgoto, tputs:/ termcap(3) 

tgoto, tputs: terminal/ termcap(3) 

tic: terminfo compiler. tied) 

time a command; report timexO) 
process 

time a command. time(1) 

time, /batch: execute at(1) 

time, /up a C shell cprofile(4) 

time, dcopy: copy file dcopy(l) 

time: get time. time(2) 

time profile.. profil(2) 

time, profile: setting profile(4) 



1192192 



lndex-98 



stime: set 



time: get 

tzset: convert date and 

clock: report CPU 

process times. 

update access and 
modification 

get process and child 
process 

file access and 
modification 

process data and 
system/ 

file. 

for a temporary file. 

/tolower, toupper, 

tolower, 

popen, pclose: initiate 
pipe 

toupper, tolower, 
toupper, 

toascii: translate/ 
toupper, 

tsort: 

modification times of a 
file. 

translate/ toupper, 
tolower, 

tolower, toascii: 

translate/ 

local RS-232 channels. 



time. 

time: time a command, 
time. 

time to string, /asctime, 
time used. 

times: get process and child 
times of a file, touch: 

times, times: 

times, utime: set 

timex: time a command; 
report 

tmpfile: create a 
temporary 

tmpnam, tempnam: create 
a name 

toascii: translate 
characters. 

to/from a process. 

tolower, toascii: 

translate/ 

tolower, toupper, 

tolower, 

topological sort. 

touch: update access and 

toupper, tolower, 

toascii: 

toupper, tolower, 
—toupper, 

tp: controlling terminal's 



stime(2) 

time(l) 

time(2) 

ctime(3) 

clock(3) 

times(2) 

touch( 1) 

times(2) 

utime(2) 

timex(l) 

tmpfile(3) 

tmpnam(3) 

conv(3) 

popen(3) 

conv(3) 

conv(3) 

tsort(l) 
touch! 1) 

conv(3) 

conv(3) 

tp(6) 



database. 

/tgetflag, tgetstr, tgoto, 

ptrace: process 

swapshort, swaplong: 

/ toupper, tolower, 

toascii: 

tr: 

ftw: walk a file 

twalk: manage binary 
search 

tan, asin, acos, atan, 
atan2: 

typesetting view/ mv: a 
values. 

/u3b, u3b5, vax: provide 

true, false: provide 

twalk: manage binary 
search/ 

interface, and terminal/ 
interface. 

a terminal. 

utmp file of the current/ 
tsearch, tfind, tdelete. 



tput: query terminfo 

tputs: terminal 
independent/ 

tr: translate characters. 

trace. 

translate byte orders to/ 
translate characters. 

translate characters, 
tree. 

trees: /tfind, tdelete, 

trigonometric functions, 
/cos, 

troff macro package for 
true, false: provide truth 
truth value about your/ 
truth values, 
tsearch, tfind, tdelete, 

tset: set terminal, terminal 

tsort: topological sort. 

tty: controlling terminal 

tty: get the terminal's 
name. 

ttyname, isatty: find name 
of 

ttyslot: find the slot in the 

twalk: manage binary 
search/ 



tputd) 

termcap(3) 
tr(l) 

ptrace(2) 

swapshortp) 

conv(3) 

tr(1) 

ftw(3) 

tsearch(3) 

trig(3) 

mv(5) 

true(1) 

machid(l) 

true(l) 

tsearch(3) 

tsetd) 
tsort(l) 
tty(6) 
ttyll) 

ttyname(3) 

ttyslot(3) 
tsearch(3) 
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file: determine file 

pdp11, u3b, vax: 
processor 

getty: set terminal 

ttytype: list of terminal 
types. 

types: primitive system 
data 

session, script: make 

/troff macro package for 

/localtime, gmtime, 
asctime, 

truth/ mc68k, pdpll, 
mc68k, pdpll, u3b, 
getpw: get name from 
limits. 

creation mask, 
mask. 

file system, mount, 



CTIX system. 



an SCCS file. 



type. 

type. mc68k, 

type, modes, speed, and 
line/ 

types by terminal number. 

types: primitive system 
data 

types. 

typescript of terminal 

typesetting view graphs/ 

tzset: convert date and 
time/ 

u3b, u3b5, vax: provide 
u3b5, vax: provide truth/ 
UID. 

ulimit: get and set user 

umask: set and get file 

umask: set file-creation 
mode 

umount: mount and 
dismount 

umount: unmount a file 
system. 

uname: get name of 
current 

uname: print name of 
system. 

unget: undo a previous 
get of 



filed) 
machidd) 

gettyd) 

ttytype(4) 
types{5) 

types(5) 

script d) 

mv(5) 

ctime(3) 

machidd) 

machidd) 

getpw(3) 

ulimit(2) 

umask(2) 

umaskd) 

mount(l) 

umount(2) 

uname(2) 

unamed) 

unget(l) 
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spaces, and/ expand, 


unexpand: expand tabs to 


expand! 1) 


get of an SCCS file 


unget: undo a previous 


unget(l) 


into input stream. 


ungetc: push character 
back 


unyeici*)/ 


/seed48, lcong48: 
generate 


uniformly distributed/ 


Oranu4o\o/ 


a file. 


uniq: report repeated lines 
in 


uniq(1) 


mktemp: make a 


UllHJUc MIC lldlllc. 


mktRniti(3) 




itnitc* rnnuorcinn nrnnrflfn 
Ullllo. LUIIVCIolUII JJIUyialll. 


unitsd 1 


unlink system calls, link. 


unlinU' ovorricp link and 
Ulllllllt. ©ABIUIOC III IK ailu 


link(l) 


entry. 


unlink* romnuo Hiroptnrv 


unlink(2) 

Willi* n\ ■»/ 


unlink: exercise link and 


unlink system calls, link, 


link(1) 


umount: 


unmount a file system. 


umount(2) 


files, pack, peat, 


unpack: compress and 
expand 


pack(l) 


times of a file, touch: 


update access and 
modification 


touch! 1) 


of programs, make: 
maintain. 


update, and regenerate 

nrm in 6 

yruupo 


make(l) 


Ifind: linear search and 


i mrlata Iconrrh 
UfJUdlc. tdcoi 


lsearch(3) 


synchronization 


■ inrlata* nrnviHp Hiclf 
UUUalc. piuviuc uion 


update ( 1 ) 


sync: 


nrtHato ciinor-hlfirlt 


svnc(21 


sync: 


update the super block. 


sync(1) 


du: summarize disk 


usage. 


du(1) 


id: print 


user and group IDs and 
names. 


id(1) 


setuid, setgid: set 


user and group IDs. 


cptiiiftl7l 


crontab- 


user crontab file. 


crontab( 1) 


character login name of 


user, cuserid: get 


cuserid(3) 



the 
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/getgid, getegid: get real 
environ: 

ulimit: get and set 

logname: return login 
name of 

/get real user, effective 

become super-user or 
another 

the utmp file of the 
current 

write: write to another 
of ex for casual 
mail, rmail: send mail to 
wall: write to all 
statistics, 
modification times, 
utmp, wtmp: 

endutent, utmpname: 
access 

ttyslot: find the slot in the 

entry formats. 

/putuline, setutent, 
endutent, 

clean-up. 

uusub: monitor 
uuclean: 



user, effective user, read/ 
user environment, 
user limits, 
user. 

user, real group, and/ 
user, su: 

user, /find the slot in 
user. 

users), /editor (variant 
users or read mail, 
users. 

ustat: get file system 

utime: set file access and 

utmp and wtmp entry 
formats. 

utmp file entry, /setutent, 

utmp file of the current 
user. 

utmp, wtmp: utmp and 
wtmp 

utmpname: access utmp 
file/ 

uuclean: uucp spool 
directory 

uucp network. 

uucp spool directory 
clean-up. 



getuid(2) 
environ(5) 
ulimit(2) 
logname(3) 

getuid(2) 
su(1) 

ttyslot(3) 

write! 1) 

edit(1) 

mail(l) 

wall(l) 

ustat(2) 

utime(2) 

utmp(4) 

getut(3) 

ttyslot(3) 

utmp(4) 

getut(3) 

uuclean( 1) 

uusub(l) 
uuclean! 1) 



control, uustat: 

bedtween computer 
systems. 

between computer/ 
uucp, 

computer/ uucp, uulog, 

system-to- 
computer/ uuto, 

and job control. 

system-to-computer 
system/ 

execution, 
val: 

u3b5, vax: provide truth 

abs: return integer 
absolute 

getenv: return 

ceiling, remainder, 
absolute 

putenv: change or add 
values. 

true, false: provide truth 
values: 

machine-dependent 

/print formatted output 
of a 

argument list. 



uucp status inquiry and job 

uucp, uulog, uuname: copy 
data 

uulog, uuname: copy data 

uuname: copy data 
between 

uupick: public computer 

uustat: uucp status inquiry 

uusub: monitor uucp 
network. 

uuto, uupick: public 
computer 

uux: remote system 
command 

val: validate SCCS file, 
validate SCCS file, 
value about your/ /u3b, 
value. 

value for environment 
name. 

value functions, /tabs: 
floor, 

value to environment, 
values: machine-dependent 
values, 
values. 

varargs argument list, 
varargs: handle variable 



uustat(l) 
uucp(1) 

uucpO) 

uucp(1) 

uuto(1) 

uustat( 1) 
uusub(l) 

uuto(1) 

uux(1) 

val(1) 
val(l) 
machid(l) 
abs(3) 

getenv(3) 

floor(3) 

putenv(3) 
values(5) 
true(l) 
values(5) 

vprintf(3) 

varargs(5) 
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varargs: handle 
edit: text editor 
mc68k, pdpll, u3b, 

option letter from 
argument 

assert: 

vc: 

get: get a 

sccsdiff: compare two 

formatted output 
of/vprintf, 

display editor based on ex. 
/package for typesetting 
on ex. vi: screen-oriented 

systems with label 
checking. 

print formatted output of 
a/ 

output of/ vprintf, 
vfprintf, 

process. 

or terminate, wait: 

exCall: Send a request and 
to stop or terminate. 

ftw: 



variable argument list, 
(variant of ex for/ 
vax: processor type, 
vc: version control, 
vector, getopt: get 

verify program assertion, 
version control, 
version of an SCCS file, 
versions of an SCCS file, 
vprintf, vsprintf: print 

vi: screen-oriented (visual) 

view graphs and slides. 

(visual) display editor 
based 

volcopy, labelit: copy file 
vprintf, vfprintf, vsprintf: 
vsprintf: print formatted 

wait: await completion of 

wait for child process to 
stop 

wait for the response. 

wait: wait for child 
process 

walk a file tree. 

wall: write to all users. 



varargs(5) 

edit(1) 

machid(l) 

vc(1) 

getopt(3) 

assert(3) 
vc(1) 
get(1) 
sccsdiff (1) 
vprintf(3) 

vi(1) 

mv(5) 

vi(1) 

volcopyO) 

vprintf(3) 

vprintf(3) 

wait(1) 
wait(2) 

excall(2) 
wait(2) 

ftw(3) 
wall(1) 
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wc: word count. 


wc(1) 




what: identify SCCS files. 


what(1) 


signal, signal: specify 


waht to do upon receipt 
of a 


signalu) 


whodo: 


who is doing what. 


whodo(l) 


who: 


who is on the system. 


wnou ) 




who: who is on the 
system. 


who(1) 




whodo: who is doing 
what. 


wnodo(l) 


fold long lines for finite 


width output device, fold: 


fold(1) 


and floppy disks, dsk: 


Winchester, cartridge, 


dsk(6) 


wmgetid: get 


window ID. 


wmgetid(3) 


wmlayout: get terminal's 


window layout. 


wmlayout(3) 


wmop: 


window management 
operations. 


wmop(3) 


window: 


window management 
primitives. 


window(6) 


wm: 


window management. 


wm(1) 


primitives: 


window: window 
management 


window(6) 


a file descriptor with a 


window, /wmsetids: 
associate 


wmsetid(3) 




wm: window 
management. 


wmu ) 




wmgetid: get window ID. 


wmgetid(3) 


window layout. 


wmlayout: get terminal's 


wmlayout(3) 


operations. 


wmop: window 
management 


wmop(3) 


file descriptor with a/ 


wmsetid, wmsetids: 
associate a 


wmsetid(3) 


descriptor with a/ 


wmsetids: associate a file 


wmsetid(3) 



wmsetid. 
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co, cnange 


working directory. 


caw 


chdir: change 


working directory. 


cndirllj 


get path-name of current 


working directory, getcwd: 


getewdt J) 


pwd: 


working directory name. 


pwrJ(l) 


swnie. syncnronous 


write on a file. 


swriieu) 


write: 


write on a file. 


wnte(Z) 


putpwent: 


write password file entry. 


putpwentuj 


wall; 


write to all users. 


wail(l) 


write: 


write to another user. 


write! 1) 




wnic. wnie on a we. 


Wlll6\£J 




write: write to another user. 


write! 1 ) 


open: open for reading or 


writing. 


open(2) 


utmp, wtmp: utmp and 


wtmp entry formats. 


utmp(4) 


formats, utmp. 


wtmp: utmp and wtmp 
entry 


utmp (4) 


accounting records, 
fwtmp, 


wtmpfix: manipulate 
connect 


fwtmpd) 


list(s) and execute 
command. 


xargs: construct argument 


xargs! 1) 


j0, jl, in. 


yO, y1, yn: Bessel 

mnr>finnp 

Tuncnons. 


bessel(3) 


j0, jl.jn, yO, 


yl, yn: Bessel functions. 


bessel(3) 


compiler-compiler. 


yacc: yet another 


yacc{1) 


jO, j1, jn, yO, yl, 


yn: Bessel functions. 


bessel(3) 
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